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CARD ASSEMBLER 



1. INTRODUCTION 



1.1. GENERAL 



Use of this manual presupposes a familiarity with the instruction repertoire and 
instruction and data formats of the UNIVAC 9200/9300 as described in "UNIVAC 
9200/9300 Systems Central Processor and Peripherals Programmers Reference," 
UP-7546 (current version). 

1.2. THE PURPOSE OF AN ASSEMBLER 

An Assembler is one result of the many and continuing efforts to improve communica- 
tions between computers and computer users. The general direction of these efforts 
has been towards an intermediate language which is close to the language of the user 
and which relies heavily on the computer for translation into its language. 



In an Assembler language all coding is represented in the form of statements which 
are understandable to the programmer. The Assembler then converts these statements 
into a binary form which is understandable to the computer. The programmer's state- 
ments, when keypunched, are called source code. The Assembler converts the source 
code into object code. Figure 1 — 1 shows the general flow of source-to-object code 
conversion with an Assembler. 



PROGRAMMER 

states the problem in the 
Language of the Assembler 



SOURCE CODE 

statements keypunched in 
card code form 



ASSEMBLY 

translation to Object Code 



OBJECT CODE 

Binary Expressions 
meaningful to the computer 



Figure 1-1. Source-to-Object Code Translation with Assembler 
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1.3. CARD ASSEMBLER FOR THE UNIVAC 9200/9300 

The Card Assembler for the UNIVAC 9200/9300 System is an efficient, easy-to-use 
software aid that satisfactorily handles most of the programming problems encountered 
by the user. Each machine instruction and data form have simple, convenient repre- 
sentations in the assembly language. The rules which govern the use of the language 
are not complex; they may be learned quickly and applied easily. 

A program in Card Assembler language for the UNIVAC 9200/9300 is written on a 
standard Univac coding form. The information on the form is keypunched, and the 
resulting source deck is read twice by the Assembler. Output cards, or an object 
deck, are produced by the Assembler in relocatable object code or absolute object code. 
The object deck is ready for loading into the UNIVAC 9200/9300 by means of the 
Card Program Loader routine. The basic flow of the UNIVAC 9200/9300 Card Assemb- 
ler and associated software is shown in Figure 1—2. Input to the Assembler is a 
card deck keypunched from an Assembler coding form or is the output from the Pre- 
assembly Macro Pass. 

The macro library is in macro code. Parameters are established for the macros by means 
of macro instructions. The Preassembly Macro Pass (described in Appendix A) converts 
the macro code into source code in preparation for assembly. 

The assembly operation is a conventional two-pass procedure which produces a card 
deck in relocatable object code. The outputs of Several separate assemblies may be 
combined by means of a Linker, The Linker output is in absolute object code. When a 
program is ready to be run, the relocatable or absolute object deck is loaded by a Card 
Program Loader subroutine. 
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Figure 7-2. UNIVAC 9200/9300 Assembly System 



UP-4092 
Rev. 2 



UNIVAC 9200/9300 
CARD ASSEMBLER 



SECTION: 



1.4. ASSEMBLY LANGUAGE CHARACTERISTICS 

The succeeding sections of this manual describe in detail the use of the Assembler 
coding form and the operational characteristics of the Assembler. These characteristics 
are summarized briefly as follows: 

Mnemonic Operation Codes — A fixed name, consisting of two, three, or four letters, is 
assigned to each machine instruction. The mme is chosen to suggest the nature 
of the instruction, thereby helping the user to learn and remember the instruction. 

Symbolic Addressing and Automatic Storage Assignment — Symbolic labels may be 
assigned to instructions or groups of data. An instruction may then reference 
the labeled data by label rather than by storage address. In many cases, other 
data required by the instruction (such as operand length) may be supplied auto- 
matically by the Assembler. Another major task of the Assembler is to keep 
track of all storage locations used and to assign all incoming instructions and 
data to specific locations. The Assembler also handles all base register and 
displacement calculations. 

Flexible Data Representation — Data may be represented in the Assembler in decimal, 
hexadecimal, or character notation, thus allowing the programmer to choose the 
most suitable form for each constant. 



Relocatable Programs and Program Linking — Programs are prepared by the Assembler 
in an absolute or relocatable form. In relocatable form, the actual storage loca- 
tions to be occupied by a program need not be specified at assembly time, or if 
specified, they may easily be altered before loading. Provisions are made for 
linking together, loading, and running as one program the results of separate 
assemblies, thereby reducing the machine time required to make changes to one 
part of a program. 

Program Listing — One of the outputs of the Assembler is a printed listing of source 
and object codes. This listing includes flags marking any errors detected by the 
Assembler. Source code errors do not cause the Assembler to stall. The Assembler 
continues to process the rest of the source code performing its usual error checks, 
thus minimizing the number of assemblies required to produce error-free code. 
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2. THE ASSEMBLER LANGUAGE 



2.1. CHARACTER SET 

The character set used in writing statements in the Assembler language consists of: 



Letters 

Digits 

Special Symbols 



A, B, C,...,Z 
0, 1, 2,. ...9 
*+-,()' blank 



2.2. STATEMENT FORMAT 



Statements in the Assembler language are written on a standard coding form. Informa- 
tion for the Assembler and comments are written in columns 1 through 71. Column 72 
must be blank. Columns 73 through 80 may contain program identification and sequenc- 
ing information. The information in columns 1 through 71 consists of the following 
fields. 

2.2.1. Label Field 

The label field begins in column 1 and is terminated by a blank column. There may 
be no embedded blanks. The field may either be blank or contain a symbol whose 
value is to be defined. More detailed information about symbols is contained under 
headings 2.3.6 and 3.1.1. 

2.2.2. Operation Field 

The operation field begins with the first nonblank after the label field and is 
terminated by a blank. It contains either the name of an assembler directive or the 
mnemonic operation code for a machine instruction. 

2.2.3. Operand Field 

The operand field begins with the first nonblank after the operation field and 
is terminated by a blank not contained in a character representation. This field con- 
tains information which defines the operands of a machine instruction or which 
supplies the specifications required with an assembler directive. 
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2.2.4. Comments Field 

The comments field begins with the column after the blank that terminates the 
operand field and ends at column 71. It may contain any combination of characters 
including blanks. It is not processed by the Assembler other than including it on 
the assembly listing. It may contain remarks to clarify the purpose or operation of 
the associated coding. A line may consist entirely of comments from columns 2 
through 71 if column 1 contains an asterisk. 



1. 
2. 
3. 
4. 



LABEL * OPERATIONS OPERAND * 
1 10 16 


*. iT,H,| IS, ,1 


S 


|A, ,C,0 


M 


Mi Ej N t Tj | L[l |N|E i • |. i i . . i. i 1 . i i i i 1 i i i. i. 1 . i. i. 


T|A,G| i I i i 




-BIA.L, i 




1 1 5i, i T i A | Gi2i i .i. I i,i i i | . . i i.i . i 1 i i i .i I i.i... 


|L| H| 1 1 | 5|, |T 


A 


G|3, , , 




, , ,T,H|E,. ,0,P l E|R,A l T,l,0|N, ,-C.O.DIE, ,1 ,S, |L,H, 


i i i i 1 i i 




LIH, , , 




li 5i , i Ti AJG 1 3 1 i i 1. i i i i. 1 . i i i i 1 i i i i 1 ,i. i 













Figure 2 — 7. Example of Source Code Statements 



Although the assembler language is free form, it is recommended that source code 
statements be written with the first character of the operation code in column 10 
and the first character of the operand field in column 16. Tabulating the statements 
in this fashion creates a program listing which is neater in appearance and easier 
to read. The standard coding form is ruled to conform to this convention. Thus, 
although the statements on lines 3 and 4 of Figure 2—1 are equivalent to the 
Assembler, the form of line 4 is preferred to that of line 3. 

The Assembler ignores the presence of any blank cards in the source code deck. 

2.3. EXPRESSIONS 

The operand field of a statement in the assembler language ordinarily consists of one 
or more expressions. Expressions may be grouped by parentheses and are separated 
by commas. For example, the basic operand formats for computer instructions are shown 
in Table 2 — 3. In this table, each subscripted letter represents an expression. An ex- 
pression may be a single term or a number of terms connected by operators. The 
permissible operators are a plus sigrt (+) representing addition and a minus sign (-) 
representing subtraction. A leading minus sign is also allowed to produce the nega- 
tive of the first term. All operations are performed in two's-complement binary nota- 
tion. A term may be one of the following: 

A decimal, hexadecimal, or character representation of an actual value. 
A location counter reference. 
A symbol. 

2.3,1. Decimal Representation 

A value may be represented directly by a string of up to five digits, through 9, 
forming a decimal number from through 32767. Such a number is converted to a 
binary value occupying one or two bytes depending on the type of field for which it 
is intended. Following are some decimal representations. 
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Decimal Representation 


Binary 


Value 


o 




00000000 


13 




00001101 


257 


00000001 


00000001 


32767 


01111111 


11111111 



2.3.2. Hexadecimal Representation 

A hexadecimal representation consists of a string of digits preceded by X' and 
followed by ' (apostrophe). Each hexadecimal digit represents a half byte of in- 
formation. The hexadecimal digits and their values are: 



- 


- 0000 


1 - 


- 0001 


2 - 


- 0010 


3 - 


- 0011 


4 - 


- 0100 


5 - 


- 0101 


6 - 


- 0110 


7 - 


- 0111 



8 - 


- 1000 


9 - 


- 1001 


A - 


- 1010 


B - 


- 1011 


C - 


- 1100 


D - 


- 1101 


E - 


- 1110 


F - 


- 1111 



Some examples of hexadecimal representations and their values are: 



Hexadecimal Representation 



X'D' 

X'101' 

X'7FFF' 



Binary Value 



00001101 
00000001 00000001 
01111111 11111111 



2.3.3. Character Representation 



A character representation consists of a string of characters preceded by C and 
followed by '. The following are valid character representations. 



Character Representation 



CD' 

C'GROSS 1 

C'9' 



EBCDIC Value 



11000100 

tLlOOOlllllOUOOl 110101101110001011100010 

11111001 



In a character representation, an apostrophe is represented by two successive 
apostrophes, and an ampersand by two successive ampersands. 

In an expression, a self-defining term in character representation can be a 
maximum of one character in length. 
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2.3,4. Location Counter 

An indication of the next location available for assignment is maintained as 
a counter called the location counter. After the Assembler processes an instruction 
or constant, it adds the length of the instruction or constant processed to the loca- 
tion counter. 

Each instruction or address constant must have an address which is a multiple of 
two. Such an address is said to fall on a halfword boundary. If the value of the lo- 
cation counter is not a multiple of two when assembling such a constant or an in- 
struction, a one is added to the location counter before assigning an address to the 
current line. Storage locations reserved by this process receive binary zeros when 
the program is loaded. 



The current value of the location counter is available for reference in the Assembler 
language and is represented by the single special character * (asterisk). If written 
in a constant representation or in an instruction operand expression, this symbol is 
replaced by the storage address of the leftmost byte allocated to that instruction or 
constant. Thus the instruction 

BC 15,* 

represents a one-instruction loop. 

2.3,5. Relative Addressing 

An instruction may address data in its immediate vicinity in storage in terms of its 
own storage address. This is called relative addressing and is achieved by an ex- 
pression of the form *+n or *-n where n is the difference in storage addresses of 
the referring instruction and the instruction or constant being accessed. Relative 
addressing is always in terms of bytes, not words or instructions. For example, in 
the coding 



LABEL * OPERATION* OPERAND t 
1 10 16 


i i i . i 1 i i 




CltL L _ L _. 




1 1 5 x , |L|M| 1 J | | | 1 | | | j.l.i i i. i . 1 ,i .. i i i 1 t 


i i i i 1 i i 




B|Ci [ i 




7i. t* i+ il 12 1 i i i . 1 i i ill i i 1.1 1 i i.ii l.i... 


l i i i 1 i i. 




A|H, , t . 




1 i5 lf |T|W|Q| i i i | i , i i I ,| i i.il 1 i i i i 1 i 


i i i.ili i 




BJC^ l^. 




1 I.5.M 1* l-l )l ?l 1 1 1 1. 1 1 il 1. 1 1 1 1 1 L.I 1 1 1 I 


i i i i 1 i i 




MIV.C, , 




A l / i B l ,i ,1 1 , -L,l. 1, J L,-U„1,„,L.,L ,,l I,.,,!,., 1 1 L„,i ,,!,„ 1 i I „,., 



the address *+12 in the second line is the address of the instruction in the last 
line and the address *-12 in the fourth line is the address of the instruction in the 
first line since each of the first four instructions is four bytes long. 
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2.3.8. Symbols 

A symbol is a group of up to four alphanumeric characters. The first, or leftmost, 
must be alphabetic. Special characters or blanks may not be contained within a 
symbol. The following are examples of valid symbols: 

A LOSS 

A72Z PRFT 

CAT 

The following are not valid symbols for the reasons stated: 

GROSS More than four characters 

N PA Embedded blank 

SR)N Special character 

A symbol may be assigned any value from through 32767. It is assigned a value, 
or defined, when it appears in the label field of any source code statement other 
than a comment. A symbol appearing in the label field of an EQU or ORG directive 
is assigned the value of the expression in the operand field. In all other cases the 
value assigned is the current value of the location counter after adjustment to a 
halfword boundary, if necessary. The value is assigned to the current label before 
the location counter is incremented for the next instruction, constant, or storage 
definition. Thus, if a symbol appears in the label field of a statement defining an 
instruction, constant, or storage area, the symbol is assigned a value equal to the 
storage area address of that instruction, constant, or storage area. 

2.3.7. Relocatable and Absolute Expressions 

A single term may be either relocatable or absolute. Decimal, character, and hexa- 
decimal representations are all absolute terms. A location counter reference within 
a section of relocatable code yields a relocatable value. If a symbol is defined by 
appearing in the label field of a source code statement within a section of relocat- 
able code, its value will be relocatable. 

An expression is relocatable in the following cases: if it consists of an absolute 
expression plus a relocatable term; if it can be reordered to have that form; or if it 
consists solely of a relocatable term. Some examples of relocatable expressions are: 

R 
A+R 

R+A 

R-R+A+R 
where R represents a relocatable term and A an absolute term. 

An expression is absolute if all of the terms in the expression are absolute or if it 
consists only of absolute terms plus an even number of relocatable terms of which 
exactly half are preceded by minus signs. Some examples of absolute expressions 
are: 

A 

A+A-A 

A-A+A+A 

R+A-R 

R-R+A 
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An expression may be negatively relocatable under certain circumstances (see 
2.5.1). Such an expression consists of an absolute expression minus a relocatable 
expression, or an expression which may be reordered to that form. Some examples 
are as follows: 



A-R 



A-R-R+R 



R-R+A-R 



2.3.8. Length Attribute 

The Assembler associates a length attribute with a symbol defined in the label field 
of a source code line representing an instruction, constant, or storage definition. 
The length attribute of such a symbol is the number of bytes assigned to the instruc- 
tion, constant, or storage area involved. The length attribute of an expression is also 
determined by the Assembler and is a function of the leading term of the expression. 
If the first term of an expression is an absolute value, a length attribute of one byte 
is assigned to the expression. If the leading term is a symbol, the number of bytes 
attributed to the expression is the same as the length attributed to the symbol. Thus, 
if TAG appears in the label field of an LH instruction (Load Halfword), it would have 
a length attribute of 4 since LH is a 4-byte instruction. In referencing the same label, 
the expression TAG+195 also has a length attribute of 4; but the expression 195+TAG 
has a length attribute of 1 because the leading term is a constant. 

When a location counter reference appears as the first term of an expression, its 
length attribute is defined as having either the length of the instruction in which it 
appears or as a length attribute of 1 (when the reference to the location counter 
occurs in an EQU statement). 

TAG EQU* The length attribute for TAG is 1 

MVC * + 12,ABC This instruction will move 6 bytes from ABC to * + 12. 



2.4. MACHINE INSTRUCTIONS 

A list of the standard machine instructions giving the numeric and hexadecimal opera- 
tion codes with the instruction type is shown in Table 2—1. 

The machine instruction format consists of a label (optional), a mnemonic operation 
code, and an operand. If a symbol is used in the label field of a machine instruction, 
it is assigned the address of the leftmost character of the instruction and receives 
a length attribute equal to the length of that instruction. There are four types of in- 
struction formats. These are shown below together with a brief explanation of the func- 
tions performed by the instructions within each format type. Table 2—2 defines the sym- 
bols used in the instruction type formats. 
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HEXADECIMAL 




MNEMONIC 


FUNCTION 


OPERATION 
CODE 


FORMAT 


AH 


ADD HALFWORD 


AA 


RX 


Al 


ADD IMMEDIATE 


A6 


SI 


AP 


ADD (PACKED) DECIMAL 


FA 


SS2 


BAL 


BRANCH AND LINK 


45 


RX 


BC 


BRANCH ON CONDITION 


47 


RX 


CH 


COMPARE HALFWORD 


49 


RX 


CLC 


COMPARE LOGICAL CHARACTER 


D5 


SSI 


CLI 


COMPARE LOGICAL IMMEDIATE 


95 


SI 


CP 


COMPARE (PACKED) DECIMAL 


F9 


SS2 


DP 


DIVIDE (PACKED) DECIMAL 


FD 


SS2 


ED 


EDIT 


DE 


SSI 


HPR 


HALT AND PROCEED 


A9 


SI 


LH 


LOAD HALFWORD 


48 


RX 


LPSC 


LOAD PROGRAM STATE CONTROL 


A8 


SI 


MP 


MULTIPLY (PACKED) DECIMAL 


FC 


SS2 


MVC 


MOVE CHARACTERS 


D2 


SSI 


MVI 


MOVE IMMEDIATE DATA 


92 


SI 


MVN 


MOVE NUMERICS 


Dl 


SSI 


MVO 


MOVE WITH OFFSET 


Fl 


SS2 


NC 


AND CHARACTERS 


D4 


SSI 


Nl 


AND IMMEDIATE DATA 


94 


SI 


OC 


OR CHARACTERS 


D6 


SSI 


01 


OR IMMEDIATE DATA 


96 


SI 


PACK 


PACK 


F2 


SS2 


SH 


SUBTRACT HALFWORD 


AB 


RX 


SP 


SUBTRACT (PACKED) DECIMAL 


FB 


SS2 


SPSC 


STORE PROGRAM STATE CONTROL 


A0 


SI 


SRC 


SUPERVISOR REQUEST 


Al 


SI 


STH 

) 

TIO 


STORE HALFWORD 


40 


RX 


TEST I/O 


A5 


SI 


TM 


TEST UNDER MASK 


91 


SI 


TR 


TRANSLATE 


DC 


SSI 


UNPK 


UNPACK 


F3 


SS2 


XIOF 


EXECUTE INPUT/OUTPUT FUNCTION 


A4 


SI 


ZAP 


ZERO ADD (PACKED) DECIMAL 


F8 


SS2 



Table 2 — 7. Instrucfion Mnemonics 
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SYMBOL 


MEANING 


R 

1 


The number of the register addressed as operand 1 


'a 


The immediate data or device address used as operand 2 




of an SI instruction. 


L 


The length of the operands * 


L i 


The length of operand i * 


S i 


The storage address of operand i 


B i 


The base register for operand i 


D i 


The displacement for operand i 



* This is the true length of the operand, not the length less one, as required in object code. The 

Assembler makes the necessary reduction of one in the length when converting source to object code. 

Table 2—2. Symbols Used in Describing Operand Formats 

2.4.1. RX — Register to Storage Instructions 



OP CODE 


REGISTER 


X 


BASE REG. 
B 2 


displacement 
d 2 



7 8 11 12 

Complete Operands Form: Ri,D2(,B2) 



15 16 



19 20 



4-byte instruction 



RX 



31 



In general, instructions in this format are used to process data between registers 
and storage and include such functions as load, store, compare, add, subtract, and 
branch. The mnemonic codes for instructions using this type of format are: 



AH 

BAL 

BC 

CH 

LH 

SH 

STH 



Add Halfword 
Branch and Link 
Branch on Condition 
Compare Halfword 
Load Halfword 
Subtract Halfword 
Store Halfword 



2.4.2. SI — Instruction to Storage Instructions 



OP CODE 



IEDIATE OPERAND 



BASE REG. 



7 8 



15 16 



19 20 



Complete Operands Form: D^B^),^ 



DISPLACEMENT 



4-byte instruction 



31 



SI 
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In general, instructions with this format are used for processing with control data 
contained in the instruction. The mnemonic codes for instructions using this type 
of format are: 



AI 

CLI 

HPR 

LPSC 

MVI 

NI 

01 

SPSC 

SRC 

TIO 

TM 

XIOF 



Add Immediate 

Compare Logical Immediate 

Halt and Proceed 

Load Program State Control 

Move Immediate Data 

AND Immediate Data 

OR Immediate Data 

Store Program State Control 

Supervisor Request 

Test I/O 

Test Under Mask 

Execute I/O Function 



2.4.3. SSI — Storage to Storage Instructions 



OP CODE 



OPERAND LENGTH 

L 



BASE REG. 
B, 



DISPLACEMENT 



SSI 



15 16 



19 20 



31 



Complete Operands Form: Dj(L, BjJ^fBo) 



BASE REG. 



32 



35 36 



DISPLACEMENT 



47 



6-byte instruction 



The instructions in this format are used to process data in storage when the 
operands are of equal length, and include such functions as comparisons, trans- 
fers, translations, and logical operations. The mnemonic codes for instructions 
using this type of format are: 



CLC 
ED 

MVC 

MVN 

NC 

OC 

TR 



Compare Logical Character 

Edit 

Move Characters 

Move Numerics 

AND Characters 

OR Characters 

Translate 
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2.4.4. SS2 — Storage to Storage Instructions 



OP CODE 


OPERAND 
LENGTH 


BASE REG. 
B l 


DISPLACEMENT / 


L l 


L 2 


°, 



15 16 



19 20 



SS2 



31 



Complete Operands Form: D^L^Bj J^^.E^) 



BASE REG. 



32 



35 36 



DISPLACEMENT 



47 



6-byte instruction 



The instructions in this format are used to process operands of unequal length 
and to process packed decimal values. The various functions include decimal opera- 
tions (add, subtract, compare), shift operations, and pack and unpack operations. 

The mnemonic codes for instructions using this type of format are: 

AP Add Packed Decimal 

CP Compare Packed Decimal 

DP Divide Packed Decimal 

MP Multiply Packed Decimal 

MVO Move With Offset 

PACK Pack 

SP Subtract Packed Decimal 

UNPK Unpack 

ZAP Zero Add Packed Decimal 



2.4.5. Implied Base Register and Length 

Where an operand is described in terms of a storage address and a length, the ex- 
pression used may be simplified from that shown in the instruction format by imply- 
ing the base register and the length. Information supplied in the USING and DROP 
directives enable the Assembler to separate a storage address into a base register 
and a displacement. If a length attribute is associated with the expression but is 
not specified in the statement, a value equal to the length of the operand is supplied 
by the Assembler. Table 2—3 lists the complete specification for the operand referenc- 
ing memory, applicable instruction types, and the operand format as it may be 
written utilizing an implicit base register and/or length representations. 
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APPLICABLE 

INSTRUCTION 

TYPES 


COMPLETE 

SPECIFICATION 

FOR ONE 

OPERAND 


OPERAND SPECIFICATION USING 


IMPLIED BASE 
REGISTER 
NOTATION 


IMPLIED 
LENGTH 


IMPLIED BASE 

REGISTER 
AND LENGTH 


RX 

SI 

SSI 

SSI 

SS2 

SS2 


D 2 (,B 2 ) 

D,(B,) 

D,(L,B,) 

D 2 (B 2 ) 

D,(L,,B,) 

D 2 (L 2 ,B 2 ) 


S 2 
S , 

S,(L) 

s 2 

S,(L.) 
S 2 (L 2 ) 


NA 

NA 
D,( ( B,) 

NA 
D,( f B,) 
D 2 (,B 2 ) 


NA 
NA 

s, 

NA 

s, 
s 2 



Table 2—3. Operand Specifications Using Implied Base Register and Length Notation 

Example: To move 80 characters from the field labeled OPA defined as a 90-char- 
acter field to the field labeled OPB and defined as an 80-character field, 
the instruction could be written as follows: 

MVC OPB, OPA 

The length attribute of OPB is implied. 

If 90 characters were to be moved, the instruction would be written 
MVC OPB(90),OPA 



2.5, DATA AND STORAGE FORMATS 

The formats for data and storage statements are similar to those for a machine instruc- 
tion. A symbol may be used in the label field. It is assigned the address of the left- 
most character of the constant or storage area being specified and is attributed with 
a length equal to that of the specified constant or storage area. The operation code 
is either DC (Define Constant) or DS (Define Storage). The operand has various 
formats which are explained below. 
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2.5.1. DC - Define Constant 

There are three types of constants: C for character representation; X for hexadecimal; 
and Y for expression. To define a constant, the assembly directive DC is written in 
the operation field. The statement has the form: 



LABEL 


OPERATION CODE 


OPERAND 


Symbol 


DC 


tLn'c' 



LABEL 


OPERATION CODE 


OPERAND 


Symbol 


DC 


Y(e) 



LABEL 


OPERATION CODE 


OPERAND 


Symbol 


DC 


YLl(e) 



LABEL 


OPERATION CODE 


OPERAND 


Symbol 


DC 


YL2(e) 



where: n is a decimal number < 16 specifying the number of bytes the constant 
is to occupy, 

t is X or C denoting hexadecimal or character representation, respec- 
tively, 

c is the actual character or hexadecimal representation for the constant, 
and 

e is any acceptable expression as previously defined. 

2.5.1.1. Character Representation 

A character representation is a string of as many as 16 characters, including 
blanks, enclosed by apostrophe marks. The apostrophe mark itself is represented 
by two successive apostrophes and an ampersand by two successive ampersands. 
In each of these cases the two characters count only as one towards the limit of 16. 
Thus, to represent a character constant of 16 apostrophes, 32 successive apos- 
trophes would be written, preceded by and ended with an apostrophe. The length 
specification may be omitted, in which case the length of the constant is deter- 
mined implicitly from the number of characters between the apostrophe marks. If 
the number of characters in apostrophes is greater than the length n, the rightmost 
characters are truncated to fit the field in the area reserved for it. If the number 
of characters between apostrophes is less than the length, the value is padded 
with blanks on the right to fill the field. 

For example, the following lines each result in a two-byte constant consisting of 
the letter A followed by blank. The third representation is flagged with an error 
indication. 
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LABEL 15 OPERATIONS 
1 10 16 




OPERAND 




1s 


i i i i 1 i i 




D|C, , , 




CLi2,' 


.A|' 


i i i i 1 i i i 


i I i i i i 1 i 


. . . I 


i i i i 1 i i 




D|Cx _l j 


_.. 


ClIiAl. 


,'| 


i i i i 1 i i i 


i 1 i i i i 1 i 


i i i I 


i i i i 1 i i 




D|C, , , 


C|L,2, 


«A| 


i B| ' i i | i i i 


i 1 i i i i 1 i 


i i i I 





















2.5.1.2. Hexadecimal Representation 

A hexadecimal representation is a string of as many as 32 hexadecimal digits en- 
closed by apostrophe marks. If the digit string is less than twice the length speci- 
fication, the field is padded with hexadecimal zeros on the left. If more than twice 
the length specification, the representation is truncated on the left to produce a 
value equal to the length. The length specification may be omitted, in which case 
the length of the constant is determined as the smallest number of bytes which 
will contain the constant specified. If necessary, the field is padded on the left 
with one hexadecimal zero. 

The following illustrates the values of source statements which represent valid 
hexadecimal constants, three bytes in length: 



CONSTANT REPRESENTATION 



VALUE 



DC 


XL3'1' 


00000000 


00000000 


00000001 


DC 


X'123A5' 


00000001 


00100011 


10100101 


DC 


X'1F3456' 


00011111 


00110100 


01010110 



2.5.1.3. Expression Constants 

Constants of type Y provide a way to write a constant involving a relocatable 
expression. If the length specification LI is not present, the expression defining 
an expression constant may have any value from —32,768 to 32,767 inclusive and 
may be absolute, relocatable, or negatively relocatable. (A negatively relocatable 
expression consists of an absolute expression minus a relocatable expression, or 
an expression that can be reordered to that form.) An expression constant in which 
the length specification LI or L2 is not present provides a convenient notation 
for representing a complete storage address. It is for this reason that constants of 
this type are called address constants. 

An address constant always occupies two bytes of storage and location counter 
adjustment to a halfword boundary is performed by the Assembler before storage 
locations are assigned to the constant. No such adjustment is performed for 
hexadecimal or character constants. 

For example, an address constant designed to generate the address assigned to 
the label 'TAG' would take the following form. 



DC 



Y(TAG) 
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An expression constant in which the length specification Ll is present may have 
any value from through 255 and may be absolute, relocatable, or negatively re- 
locatable. It always occupies one byte of storage, and no location counter adjust- 
ment is made before assigning a memory location to the constant. It is useful when 
an externally defined symbol is assigned to only one byte. 

An expression constant in which the length specification L2 is present is the same 
as an expression constant in which no length specification is present, except in 
the former case, no halfword boundary adjustment is made. 

A summary of constant types, lengths, padding and truncation rules appears in 
Table 2-4. 



CONSTANT 
TYPE 


EXPLICIT 
LENGTH 


IMPLICIT 
LENGTH 


TRUNCATION 
OR PADDING 


C 


variable 
1-16 


rtfaximum 
16 


on right side 


X 


variable 


maximum 


on left side 


1-16 


16 






/ not 


2 


on left side 


Y 


Istated 








j 1 


none 


on left side 




\ 2 


none 


on left side 



Table 2—4. Characteristics of the Various Constants 
2.5.2. DS - Define Storage 

The format of the assembler language statement to reserve storage is as follows: 



LABEL 


OPERATION CODE 


OPERAND 


Symbol (Optional) 


DS 


dCLn 



LABEL 


OPERATION CODE 


OPERAND 


Symbol (Optional) 


DS 


dH 



where: d is a non-negative integer called the duplication factor, the number of 
fields to be reserved (d may be a maximum of 256), 

n is a decimal number representing the length of the field to be reserved 
(n may be a maximum of 256 and a minimum of one), 

H represents a field whose length is two bytes and whose storage 
address must be on a halfword boundary. 
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15 



The statement DS OH causes the location counter to be adjusted to a multiple of 
two without reserving storage. A duplication factor of zero may be used with any 
storage definition statement to define the address and length of a field without re- 
Serving storage for it. The duplication factor may be omitted, in which case a factor 
of one is assumed. 

Thus: 



CARD 


DS 


0CL80 


FRST 


DS 


CL40 


LAST 


DS 


CL40 



would define an 80-byte field named CARD, a 40-byte field named FRST whose 
address is the same as that of CARD, and a field named LAST whose length is 40 
bytes and whose address is 40 greater than that of CARD and FRST. 

The location counter is not increased in assembling CARD (because duplication 
factor is 0) but is with FRST and LAST. Therefore, 40 + 40 = 80 spaces are reserved, 
with FRST and CARD assigned the starting location and LAST assigned the mid- 
point. When the duplication factor is specified, it defines the number of fields of 
length n (for C) or the number of pairs of bytes (for H) to be reserved. For example, 



TAG 



DS 



13H 



reserves 13 pairs of bytes. The symbol, TAG, refers to the first pair of bytes only 
and not to the entire 26 bytes. TAG would have a length attribute of two in this 
instance. For example, 



TAG1 



DS 



10CL10 



reserves 10 groups of 10 bytes each, or 100 bytes. The symbol TAG1 refers to the 
first group of ten bytes and not to the entire 100 bytes. In this instance TAG1 would 
have a length attribute of ten. 
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ASSEMBLER DIRECTIVES 
AND SYSTEM CODES 



3.1. DIRECTIVES 

In addition to the representation of machine instructions, constants, and storage, 
the Assembler language includes several assembler directives. These are instructions 
to the Assembler to perform certain functions and provide the user of the Assembler 
language with control of the operation of the Assembler. 

The assembler directives, grouped by function, are as follows: 

Symbol Definition 

EQU 
Assembler Control 

START 

END 

ORG 

Base Register Assignment 
USING 
DROP 

Program Linking 
ENTRY 
EXTRN 



Assembler directives, except START, may use a symbol in the operand field, and, 
with the exception of ENTRY, EXTRN, USING and DROP, the symbol must have 
appeared in the label field of a previous statement. 

3.1,1. Symbol Definition 

EQU - Equate 

The value and length attribute of a symbol may be defined explicitly. The statement 
to accomplish this has the following form: 



LABEL 


OPERATION 


OPERAND 


Symbol 


EQU 


e , , e 2 



where: e, and e 2 are expressions and must have been previously defined. 
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The symbol is defined to have a length attribute equal to the value of the second 
expression in the operand. The second expression in the operand may be omitted, 
in which case the symbol is defined to have the length attribute of the first ex- 
pression. 

The symbol in the label field is defined to have the value of the first expression in 
the operand field. If the value of the first expression in the operand field is not 
between and 32767, the statement will be flagged with an error indication and the 
symbol will remain undefined. 



Thus, if the value of the location counter is 2000 when the following lines are 
encountered, 



LABEL t> OPERATION* OPERAND * 
1 10 16 


T I A i G i l 1 l i 




ELQiU L _j 


-- 


2 1 5 |C, L| 1 | 0| i i i | i i i i | i i i i 1 i i i i 1 i 


H,l ,D, E, | i i 




1 1O1O1 + 1TI A, G,. ,1 ,510, , i , 1 i , i , 1 i i , , 1 , 


S |E |E i K i | i | 




ElQiU, , 


T, A,G| + |2| 7| 0| -i *i | i i i i | i i i i | i i i i | i 











TAG has a relocatable value of 2000 and a length attribute of 10. 
HIDE has a relocatable value of 2100 and a length attribute of 150. 
SEEK has an absolute value of 20, and a length attribute of 10. 



3.1.2. Assembly Control 

Assembler directives are available to control the program name and initial location, 
alter the location counter in a specified manner, and indicate the end of the program 
statement and the instruction with which execution of the object program is to begin. 

3.1.2.1. START - Program Start 

The START directive defines the program name and tentative starting location. 
It must precede all other program statements in the source code deck except 
comments. The format of the START directive is as follows: 



LABEL 


OPERATION 


OPERAND 


Symbol 


START 


Decimal or Hexadecimal representation 



The expression in the operand field is evaluated and incremented if necessary to 
make it a multiple of four. The result becomes the initial setting of the location 
counter and is the value of the symbol in the label field. This symbol becomes 
the Program IDentification (PID) and is available as an entry point without being 
separately defined as such (see 3.1.4). Although the operand of the START 
directive is an absolute value, it is treated as relocatable. 
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Thus the value of the location counter and the coding which follows a START 
directive are both relocatable. Any one of the statements below would result in 
the program having the name SORT, being assigned to locations starting at 1068, 
and having the symbol SORT defined with the relocatable value 1068. 



SORT 


START 


1065 


SORT 


START 


1068 


SORT 


START 


X'42C 



A START directive preceded by one or more statements other than comments is 
ignored and flagged as an error. A START directive whose operand field does not 
have a value from to 32764 is ignored and flagged as an error. If there is no 
valid START directive, the program name is left blank and the location counter 
is set to 0. 

3.1.2.2. END - Program End 

The END directive indicates to the Assembler the end of the program being 
assembled. The format of the END directive is 



LABEL 



Symbol (optional) 



OPERATION 



END 



OPERAND 



Expression (optional) 



With an END directive the Assembler stops reading cards, punches any remaining 
data which has accumulated, and then punches a Transfer Card. If the operand 
field of the END directive contains an expression, this expression is punched 
into the Transfer Card to signify to the load routine the address at which to begin 
program execution. If there is no expression in the operand field of the END 
directive, the corresponding field of the Transfer Card is blank. In that case when 
the load routine encounters the Transfer Card, it transfers control to the first 
location loaded. 

If a symbol appears in the label field of the END directive, it is assigned the 
current value of the location counter. This is normally one greater than the high- 
est address assigned to the program being assembled. 



3.1.2.3. ORG - Set Location Counter 

The ORG directive is used to set the location counter to a specified value. The 
format of the ORG directive is as follows: 



LABEL 


OPERATION 


OPERAND 


Symbol (optional) 


ORG 


e l' e 2 
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The value to which the location counter is set is determined by the values of the 
expressions in the operand field. If en is not specified, then the location counter 
is set to the value of e*. If ^ * s expressed, the location counter is set to the next 
value greater than or equal to the value of e^ which is a multiple of q^- Examples 
follow: 



OPERAND 

1000 

1000,2 

1000,16 



RESULTING LOCATION 
COUNTER VALUE 

1000 
1000 
1008 



The value of en must be a power of two. 

If a symbol appears in the label field, its value is also the value to which the 
location counter is set and the symbol is assigned a length attribute of one. The 
value must be either an absolute value between and 32767 or a relocatable value 
between the initial location counter setting and 32768. If the value does not lie 
within this range, the ORG directive is ignored and the line is flagged with an 
error indication. With the ORG directive it is possible to set the location counter 
to a value which is not a halfword boundary. 

The ORG directive to set the location counter to a value 603 less than its current 
setting would be as follows: 



LABEL 



OPERATION 



ORG 



OPERAND 



-603 



The ORG directive may be used to reserve a number of locations which are not 
expressed as a single decimal integer. For example, to reserve A minus B bytes 
of storage where A and B are previously defined symbols, the statement is written 
as follows: 



LABEL 



OPERATION 



ORG 



OPERAND 



*+A-B 



Bytes of storage reserved either with a DS or ORG directive are not set to zero 
when the program is loaded. 

If e^ is a relocatable expression, the value to which the location counter is set 
and the coding that follows the ORG directive are both relocatable. If absolute, 
the value to which the location counter is set and the coding that follows the ORG 
directive are both absolute. 



3.1.3. Base Register Assignment 

The Assembler assumes the responsibility for converting storage addresses to base 
register and displacement values for insertion into instructions being assembled. 
To do this the Assembler must be informed of the available registers and the values 
assumed to be in those registers. The assembly directives USING and DROP are 
available for this purpose. 
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3.1.3.1. USING - Assign Base Register 

The USING directive informs the Assembler that a specified register is available 
for base register assignment and that it contains a specified value. The format 
of the USING directive is as follows: 



LABEL 


OPERATION 


OPERAND 


Symbol (optional) 


USING 


R,A 



where: R is a relocatable expression and A is an absolute expression. 

It is also possible to specify an absolute value for the first expression in 
the operand of a USING directive. 

The first expression represents the value the Assembler assumes is in the speci- 
fied register at object time. The second expression in the operand field must be 
a number from 8 through 15 which denotes the general register specified. 

3.1.3.2. DROP - Unassign Base Register 

The format of the DROP directive is 



LABEL 


OPERATION 


OPERAND 


Symbol (optional) 


DROP 


Absolute expression 



This directive informs the Assembler that the specified base register no longer 
contains a value available to the Assembler for computing base register and dis- 
placement values. The expression in the operand field of the DROP directive is 
a number from 8 through 15 which denotes the general register no longer available. 

3.1.3.3. Function of USING and DROP Directives 

The Assembler maintains a table of the available registers and the values they 
contain at object time. This table is referred to as the USING table. A USING 
directive adds a register and value to the USING table or revises the value for a 
register already in the table. A DROP directive removes a register and its asso- 
ciated value from the table. If the operands of a USING or DROP directive are not 
valid, the line is flagged with an error indication. 

If an operand address is given as a relative address instead of as a base register 
and displacement specification, the Assembler searches the USING table for a 
value yielding a valid displacement, that is, a displacement of 4095 or less. If 
there is more than one such value, that value which yields the smallest displace- 
ment is chosen. If no value yields a valid displacement, the operand address is 
set to zero and the line is flagged with an error indication. If more than one reg- 
ister contains the value yielding the smallest displacement, the highest numbered 
register is selected. 

An absolute address with no base register indicated is treated as an absolute, 
direct address. 
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The placement of a USING directive determines the instructions whose operand 
addresses may be decomposed based on that USING statement. The first operand 
of the USING statement determines the portion of the program which may be 
addressed using the specified register. Thus, if a program contains the coding 



, uiBEL \°,r ERiT """', s operah,> • co "" ehts 


72 


80 






U|S,I ,N|G 










'l II 1 1 1 1 




y±Li_i, 














u iVi N i G 


















































jjluii 
















B , , , , 1 , , 




d i<; ( i 








-J_L.ij...Ll_l_ 


c 1 




bil_u- 










•i 1 1 1 



















































the B2 and D2 fields of the instruction labeled A will contain 10 and 0, respec- 
tively. Moreover, if the program contains no USING directives for register 10 other 
than the ones shown, then the second line labeled A is the only line in the pro- 
gram for which the Assembler would consider 10 as a register available for address- 
ing the line labeled B. 

The load routine stores in register 13 the starting address of the program just 
loaded. All other registers must be loaded by the program itself in a manner con- 
sistent with the information given to the Assembler in the USING directives. The 
following example shows how this is done. 



LABEL t> OPERATION* OPERAND t 
1 10 16 


, , i , 1 ■ , 




U 1 S , I ,N,G 


— 


A| , i 1 1 3 1 I i i i i 1 i i i i I i i i i I i i i i I i 


A, , i i | i , 




kLH|_ |_ L 


1 .2 . . i Bi 1 i i i . 1 i i i i 1 . i . i 1 i . i . 1 i 


i i i i 1 i i 




UlSil 1N1G 


Ci. il 1 2i I i i i i I i i i i | i i i i I i i i i I i 






dL_l_L_L 




i .i i i 1 i i . i 1 i i i i 1 i i i i 1 i i i i 1 i 






. 1 . . . 


iiiiIiiiiI.iiiIiii.Iiii.I. 






i_L_L L. L_ 




i i i i 1 i i i i 1 i i i . 1 . i i i 1 i i . i 1 . 


Bi i i , I i i 




D|C, , , 




Yi ( |C| ) i | i i i i | i i i i | i i i i | i i i i | i 


, , i , 1 , i 




• 1 1 1 1 


— 


i i i i 1 . i i i 1 i i i i I i . i i 1 i i . i 1 i 


__L_^_L^L_L_^__ 




•I,,, 


i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i 


> 1 1 I ! 1 1 




•1,1, 




. . i . 1 i i i i 1 i i i . 1 i i i i 1 i i i i 1 . 


_Cl_j_j _±_J__1_^ 




DIS. i i 




Ci Li 1 iO. 1 i i . . 1 . i . . 1 . . . I 1 . i . i 1 . 


1 l i l 1 1 l 




•_! J_1_L 




i . . i 1 i i . . 1 i i i i 1 i i i . 1 i i i I 1 I 


, , , , 1 , , 




•l.i. 




i i i i 1 i i i i 1 i . i i 1 i I i i 1 i i i i 1 i 


..III.! 




•I.., 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i 


, I , I 1 , , 




E|N|D, , 




A. . i i I i . i i I i i i i I i i i i I i i i i I i 













Lines two and three of the above example exemplify the following general rule: 

The loading of a value into a general register must precede the USING 
directive which informs the Assembler the value is available. 
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It is also possible to specify an absolute value for the first expression in the 
operand of a USING directive. The entry in the USING table made in response to 
such a USING directive is not used to decompose relative addresses. It is used 
instead to decompose absolute addresses. For example, given the following coding 



USING 
LH 



4000,15 
14,4096 



B2 and D2 fields of the instruction labeled A will contain 15 and 96 respectively. 

3.1.3.4. Direct Addressing 

The machine instruction format provides for either base register and displacement 
addressing (indexed addressing) or direct addressing. Instructions using direct 
addressing have a faster execution time. To facilitate error checking by the 
Assembler, direct addressing is described to the Assembler in terms of the 
pseudo base registers 0, 1, 2, 3, 4, 5, 6, and 7 which contain the values 0, 4096, 
8192, 12288, 16384, 20480, 24576 and 28672, respectively. Thus, the direct 
address 512 would be treated by the Assembler as an address consisting of a 
reference to the pseudo base register and a displacement of 512. The address 
4098 would yield a base of 1 and a displacement of 2. The additional forms of the 
USING directive which are available for direct addressing are, specifically 



LABEL 


OPERATION 


OPERAND 




USING 


*,0 




USING 


M 




USING 


*,7 



The first line above makes direct addressing available for addresses in the range 
to 4TT95. The second makes direct addressing available for addresses in the 
range 4096 to 8191, and so on. The DROP directive may also refer to the pseudo 
registers through 7 to terminate direct addressing. 

A program involving direct addressing may still be relocatable. 

The asterisk (*) when used in the operand of the USING directive specifying a 
pseudo base register has a unique meaning and does not have the normal con- 
notation of the current value of the location counter. 



3.1.4. Program Linking 

The Assembler provides, as part of its output, information which allows the results 
of separate assemblies to be linked together, loaded, and then executed as a single 
program. Proper sectioning reduces the machine time required to make changes to an 
existing program. If a change is required, only that part which is changed need be re- 
assembled; The output is then linked with the remaining parts to produce the altered 
program. Proper sectioning of a program also reduces the number of symbols required 
in each of the separate assemblies. 
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A symbol defined in the label field of element A and addressed in element B is said 
to be externally defined in element A and referenced in element B. Thus, by using 
the ENTRY and EXTRN directives, proper linkage is supplied when the separate 
elements are assembled. This information is handed on to the Linker program by the 
External Definition Cards and the External Reference Card which are outputs of the 
Assembler. 

3.1.4.1. ENTRY - Externally Defined Symbol Declaration 

That portion of a program submitted as input to a single assembly is called an 
element. Each element must declare the symbols defined within that element and 
to which reference is made by other elements. Each symbol is referred to as being 
externally defined and is declared by the ENTRY directive. The ENTRY directive 
has the format 



LABEL 



OPERATION 



OPERAND 



ENTRY 



Symbol 



The symbol in the operand field is declared to be externally defined. Its name and 
assigned value are included in the output of the Assembler as an External Defini- 
tion Card. 



3.1.4.2. EXTRN — Externally Referenced Symbol Declaration 

The Assembler must also be informed of all symbols referred to in the element 
being assembled but which are defined in some other element. A reference to 
such a symbol is called an external reference, and such symbols are declared in 
the EXTRN directive. The format of the EXTRN directive is 



LABEL 



OPERATION 



EXTRN 



OPERAND 



Symbol 



The symbol in the operand field is declared to be a symbol defined in some other 
element. A symbolic name and the External Symbol Indentification assigned by 
the Assembler are included as input of the Linker as an External Reference 
Card. 



3,1. 5. Assembler Program Listing 

Figure 3-1 is a comprehensive example of coding in UNIVAC 9200/9300 Assembler 
language. The listing shown is a reproduction of an actual printout from the prototype 
UNIVAC 9200/9300 System. The example is coding for the self-loading memory dump 
routine described in "UNIVAC 9200/9300 Programming Utility Reference Manual," 
UP-4120 (current version). 



ouol 

OOu<? 
ijOlU 

ouuu 
OOub 
l)Uub 
00U.7 
UUOtt 

ouoy 

OU1U 
UOll 
0U12 
0013 
OOiU 
UOlb 
OUib 
OUi./ 

uoia 
uuiy 

ou^ 

00<£3 
OU<;<+ 
uU«2b 
OOth 
UO«i7 
UU<iW 

ou«iy 

UU3U 

0032 

JUJ3 
OU3b 



MD 



OOOA 

(jooa ooooooouooouuouuooil 
uoiu noooououoouuuouu 

OOIC n201004bOU42 
U022 Q25U00Ub 
0026 A4010002 
y02A H77U003L 
U02E AbUlOOOu 
0032 «7200U2t- 
0036 "1CO0O0U 
003A U7800F7U 
003E A90021CU 
0042 OFbb 



THIS MtN>OHY OU*P ROUTINE IS ADJUSTED TO THE 
MACHINE CONFIGURATION. 

MDSLF PQS=132,CHs63 

THf HOLLOWING CODING IS EQUIVALENT TO. THE SOURCE CODE 

WHICH IS GENERATED BY »HE ABOVE MACRO INSTRUCTION. 

PARAMETER EXPLANATION 

PAP.l POS = 96. 120, OK 132 FOR PRINTER CH. POSITION. 

PAP. 2 CH = 63 OR 48 ^OR AN ASSOCIATED PRINT BAR. 

PAR. 3 BPN = BLANK OR 128 THROUGH 32767 FOR THE 

LOCATION AT WHICH MEMORY DUMP IS TO BEGIN. 
PAR. 4 END = BLANK OR 128 THROUGH 32767 FOR THE 

LOCATION AT WHICH MEMORY DUMP IS TO END. 
PAP. 5 MEM = 8*»12K.16»<»ANP 32K , IF THE ENTIRE MEMORY 

IS TO BE DUMPED AND THE ROUTINE IS TO BE 

LOADEn INTO THE HIGHEST MEMORY LOCATIONS. 

OTHERWISE BLANK. 
PAP. 6 LOAD = 260 THROUGH 32190 FOR THE LOCATION 

AT WHICH MEMORY DUMP IS TO BE LOADED. 

BLANK IF l»EM PARAMETER EXISTS. 
RDR = BLANK OR 1001 FOR AN ASSOCIATED READER. 



LOADER SECTION 1ST CARD 

SET BASE ADDR FOR 2^0 CARD 

CON.l SET 80 TO D.C AREA 

READ CARD 

IS XIOF ACCEPTED? 

TEST I/O STATUS 

IS PEADER WORKING? 

TEST STATUS BITS 

IS THERE ANY FRROR? 

READER OFF NORMAL RESTART H 

ADDRESS FOR 2ND CARD 





PAP. 7 RDF 


START 





USING 


*»P 


ORG 


10 


DC 


XLIO'IC' 


DC 


XL8'0« 


MVC 


70(2). 66 


MVI 


69.80 


XIOF 


2»1 


RC 


7.62 


TIO 


0.1 


BC 


2»»*6 


TM 


O.X'CO* 


BC 


8.3952 


HPR 


X»21C0' .0 


DC 


Y(3942> 





MD 
MD 


1011 
1020 




MD 


1030 




MD 


1040 




MD 


1050 




MD 


1060 




MD 


1070 




MD 


1080 




MD 


1090 




MD 


1100 




MD 


1110 




MD 


1120 




MD 


1130 




MD 


1140 




MD 


1150 




MD 


1160 




MD 


1170 




MD 


1180 




MD 


1190 




MD 


1200 




MD 


2010 




MD 


2011 




MD 


201? 


N 


MO 


2020 




MD 


2030 


P» 


MD 


2040 


P 


MD 


2050 


P 


MD 


2060 


DY 


MD 


2070 


P 


MD 


2080 


DM 


MD 


2090 


P 


MD 


2100 


DY 


MD 


2110 


H 


MD 


2120 




MO 


2130 
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003b 


U'>4U 


noOAOOUe 


0Jj7 


OF 70 




U038 


0F70 


950U0FAF 


00,19 


0F74 


'*7d00FAu 


OUhU 


0K78 


«50A0FA(- 


UU-+1 


0F7C 


•»7800F6<+ 


U042 


UF80 


«4 7K00F9b 


00<+3 


0F84 


n20UQF9lOFBu 


ou«+u 


0F8A 


H2010F920FB2 


00H5 


OF90 


fl2000FAC0FB8 


004b 


OF 96 


n20100«+bnFAA 


0047 


0F9C 


«*7F0002i 


0048 


OFAO 


n2010FAoDFBt 


0049 


0FA6 


«7FUO00O 


0050 


OFAA 


OF At 


0051 


ODBC 




0052 


ODBC 


noou 


0055 


OOBE 


OFFF 


0054 


UOCO 


H080 


0055 


0DC2 


nFdO 


005b 


U0C4 


nFCO 


0057 


0OC6 


0FF4 


3058 


0DC8 


U05CF0F1F2F3F4F5F6 


0059 


0OD1 


F7F8F9ClC2C3C«tC5C6 


0060 


OOOA 


O2060050 


OOol 


OODE 


92000F6C 


0062 


0UE2 


n2020F6D0F6t 


0063 


0DE8 


U8E00F6C 


Q0o4 


ODEC 


H2010F6AODC4 


0065 


0OF2 


A4030001 


006b 


0DF6 


'+7800E1Q 


0067 


OOFA 


*5030F7u 


0068 


uofe 


U7200DF2 


0069 


0E02 


D2000E060F70 


0070 


0E08 


A9002300 





DC 


XL" •OAUoUd' 




ORG 


39f>2 




CLI 


♦ ♦f^.X'OC 




RC 


r,*+HH 




CLI 


♦♦^SfX'OA 1 




HC 


P»*+8 




BC 


lb»*+22 




MVC 


*+13(l>,*+44 




MVC 


*+B<2) »*+40 




MVC 


*+28(l> ,*+U0 




MVC 


70(2) »*+20 




BC 


15'34 




MVC 


*+R<2)»*+2« 




BC 


15»0 




DC 


Y(*+4) 




ORG 


*-496 


MB6N 


DC 


Y(0> 


MEND 


DC 


Y<4095) 


M?CO 


oc 


Y(128) 




DC 


Y(M?PW+6) 




DC 


Y(M?Pw+70) 




DC 


Y<m?Ph+i32-10) 


M?TB 


DC 


XU9 • H05CF0F 1F2F3F4F5F6 ' 




DC 


XL9•F7F8F9C1C2C3C^C5C6• 


MENT 


MVI 


80»X'08« 




MVI 


M?CN+2»0 




MVC 


M?CN+3(3)»M?CN*2 




LH 


lH»M?CN+2 




MVC 


M?CN(2)»M?C0+4 


M?A 


XIOF 


1»3 




BC 


8»M?B0 




TIO 


M?CN+b»3 




BC 


?»M?A 


M?E 


MVC 


*+9(l) »M?CN+6 




HPK 


X»2300'.O 



DEV'CE CONTROL FOR 1ST CARD 
LOADER SECTION 2ND CARn N 
IS THIS A TYPE Y CARD? DN 
IF Y CARD GO TO CON. 4 C 
IS THIS A TYPE CARD? DY 

C 
IF MO GO TO CON. 5 C 

SET LENGTH FOR LOAD 
SET ADDRESS FOR LOAD 
LOAD TEXT P 

CON. 5 SET BASE ADDRESS P 
GO TO CON.l (1ST CARO) B 
CON. 4 SET START ADDRESS P 
GO TO MEMORY DUMP B 

ADDRESS FOR SUBSEQUENT CARD 
MEMORY DUMP SECTION N 

CONST. FOR REGINISfl/NO AODRESS 
CONST. FOR ENDING A0ORES5 
CONSTANT 12B 

STARTING ADDRESS FOR EDIT 
ENDING ADDRESS FOR EDIT 

TRANSLATION TABLE FOR 

63 CH BAR 

M.D. ENTRY SET LINE ADV BIT P 

SET VC Bl»Ct»Fl»AND Kl P 
SET REG 14 TO ZERO P 

SET LIMIT OF EDIT TO 4 GR. P 
ISSUE PRINT ORDER 63 CH BAR P 
IS ORDER ACCEPTED? ON 

TEST I/O STATUS P 

IS PRINTER WORKING? DN 

SET STATUS RITS FOR DISPLAY P 
PRINTER OFF NORMAL H 



MO 2141 

MD 2150 

MD 2160 

MD 2170 

MD 2180 

MO 2190 

MD 2200 

MD 3010 

MD 3020 

MD 3030 

MO 3040 

MO 3050 

MD 3060 

MO 3070 

MD 3080 

MD 3090 

MD 3100 

MD 3110 

MD 3120 

MO 3130 

MO 3140 

MO 3150 

MO 3160 

MD 3170 

MO 3180 

MD 3190 

MD 3200 

MD 4010 

MD 4020 

MO 4030 

MO 4040 

MD 4050 

MD 4060 

MD 4070 

MD 4080 
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0/1 


OFOC 


'i7F0 0UF^ 


J0f2 


UE10 


"bOU'FbC 


00/3 


oei4 


'»7800cHm 


Ul)/t 


UK- 18 


r '2fc.L0F7M 


00/b 


UE1C 


^2820f-7unF/M 


i.)U /b 


UF22 


"bOl^fbU 


00// 


UE26 


'J76untC t 


00/8 


UF2A 


"5020F6U 


00/9 


0F2E 


«7dUdtC« 


dOdl) 


UF3? 


UttFUOUC^ 


OUol 


OF 3 6 


F3 ( 4cOF7/»nu3u 


00d2 


UK3C 


ri 2tLnF7L 


UUo3 


UF40 


t-3L /f-'OOOE uoo 


00d4 


OFi+f, 


(-"llUP'OOLEUU/ 


OOob 


utuc 


"dFuFUOl 


OOcio 


uEbO 


cl 6FOFuOr 


0o/ 


OF 54 


n2UinF7tFu0b 


JOoB 


OF 5 A 


«6l2003t 


j9 


0E5E 


*60t>r)03C 


00^0 


0F62 


«7lo0tAi_ 


0^1 


UF66 


'i9Lonufic 


Qti'J2 


0F6A 


u72ontAt. 


00-J3 


0F-6E 


U9Foni-6rt 


94 


OF 72 


u74U0L4u 


Jb 


0F76 


H9LU0OCU 


oJyo 


UF7A 


'i7'300L8u 


09/ 


0E7E 


' , 20bOE74ni- /,. 


ju-ju 


Of 1 m 


ngUO'if b<_ 


Jji4 


UF8H 


W7K00I-1,. 


01 00 


UP 8C 


opoinf f^ 


olol 


UK9H 


n^oiuf-bMr jlu 


j1j2 


Uf- 9 b 


'IriLUOOiil 


01 Jj 


LK9A 


'ii»H"m3l- 


.tlui 


l^"9F 


"9Lo'UCu 


JlJ'l 


Ot A? 


"7>\L"f-lc 



M?bP 



M?t1 



HC 


1b» v ?A 


CLI 


^?CN+2« 1 


PC 


p.?r-'?Hi> 


MVI 


f'?P■<l^*.'Z^ , 


«vc 


f"?f W + l ( 132-1 ) i m ?Pa 


CLI 


"iTM+3»l 


HC 


f'^'?C2 


CLI 


M?CN+^»2 


RC 


Pft ?C3 


LM 


1 b«M?C0+2 


IINHK 


f'PFWtb) #b0(3) 


M Vi 


r.- > PW44»X'tF« 


CNPK 


( 1 b , 1 b ) r ( R » 1 « ) 


"VO 


J4(2»lb)»7(l»iu) 


01 


14 (lb) »X'Fn« 


01 


lb(lb) »x'Fnt 


MVC 


^?CN4£j(2) rb(l4> 


AI 


b2»18 


AI 


M- » 8 


HC 


1 r ? '?H 


CM 


1 <+ r^trgn 


HC 


?>''?H 


CM 


.i.b»M?CM 


HC 


'♦ »"". J L! 


CM 


m (W^ci) 


HC 


^»*+ia 


"VC 


'"iTN+l fi (f,) iM?CM+R 


""VI 


'".->CIH<+»0 


I'C 


1 b>'-'?L 


"VI 


?V"N + 3» 1 


"VC 


«- Jf M( c ' ) f f.'?ro + 6 


I.H 


14. M BGN 


Ml 


^l»V'pii 


CM 


1 4 , ?' J(.n 



GO TO A FOR RECOVER V 

IS VC RP SET TO B2? 

IF YES GO TO P2 

lit 

CLE^R STArjDMY P.RUF^FP AREA P 

CO IS VC CO SET TO CP? 

IF *ES GO T" C2 

IS VC CH SET TO C3? 

If- Yfc; GO TO C3 

SET START I NO ADDR OF FDTT 

EDIT ADDRESS 

EDIT DATA 7 BYTES 
EDIT DATA 8TH bYTE 



STORE PREDECESSOR B Y TFS 

Rib + IP TO Rib 

HI 4 + 8 TO "14 

IF P1'4 OVERFLOW GO TO H 

IS RIO FQUAL TO MEM LTMTT? 

IF YES GO TO H 

IS "is FQUAL TO EDIT LP' IT? r>Y 

IF' MO G<"> TO D 

IS D 1U EQUAL. TO 126? 

IF Yrs GO T<"i SS 

E.XTFMO PRFDFCf-SSOR ^YTES 

SET VC ^0 T^ Fl 

GO to L 

bS SET VC CO T<"> 0? 

SET LIMIT OP F LIT 

SET RFGINHP'G A n DP TO Ritj 

AND fPASE 4 LSF 

IS no. AH. SMALLER T W AM 1?8? DY 

1L "0 3 n TO L 



R 


MD 


4090 


dm 


MD 


mon 


C 


MD 


tun 


N 


MD 


Ul2 n 


P 


MO 


113n 


DM 


MD 


Ui<+n 


C 


MD 


'+15n 


dm 


MD 


416^ 


C 


MD 


UJ7" 


p 


MD 


4181 


p 


MD 


4191 




MD 


4?0i 


p 


MD 


S011 


p 


MD 


502 n 




MD 


S030 




MD 


S041 


p 


MD 


Sf!5 n 


p 


MD 


^061 


p 


MO 


S07T 


DM 


MD 


■S08O 


n> ! 


MD 


S090 


C 


MD 


S101 


nv 


MD 


SI li 


C 


md 


S121 


DM 


MD 


SI 3i 


C 


MD 


S141 


p 


MD 


Slbi 


P 


MO 


S161 


13 


MO 


SI 71 


P 


MD 


SI 81 


P 


MO 


sign 


P 


MO 


s?oi 


c 


MO 


ftflin 


DY 


MO 


f>02l 





MD 


ft03i 
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OlUb 


UEA6 


48EU0DCU 


0107 


OEAA 


U7F0QF12 


Qlutt 


OEAE 


92010F6L 


0109 


0EB2 


O2010F6H 


ouu 


0EB6 


47FU0Hi2 


0111 


OEBA 


Q2000F6C 


0112 


OEBE 


47F00F18 


0113 


UEC2 


O2020F6U 


0114 


0EC6 


47F0OE32 


011b 


OECA 


48D0003C 


Olib 


OECE 


u8F0nOC2 


0li7 


0ED2 


P5O7DO0UOF72 


una 


OEOfl 


U7600E32 


0119 


OEDC 


A612003u 


0120 


OEEO 


A60b003rt 


0121 


0EE4 


U7100E32 


0122 


0EE8 


U9U0ODBL 


0123 


OEEC 


«72U0E32 


0124 


OEFO 


49F00F6A 


012b 


0EF4 


474U0ED2 


012b 


UEFR 


"8EU003A 


012 7 


OEFC 


P5010F6L 


0126 


OFOO 


47800ECt 


oi2y 


0F04 


O2010F6t 


0130 


0F08 


«2EF0F8tt 


0131 


OFOC 


n269C)F92nF8u 


0132 


0F12 


nC830F7A0CUA 


0133 


0F18 


»503nF7u 


0134 


0F1C 


'*72U0Flb 


013b 


0F20 


"1F90F7U 


013b 


0K2<+ 


U78U0F30 


0137 


0F28 


"2010F6C 


013b 


UF2C 


U7F00E02 


U139 


UF30 


"5010F6I- 


0140 


UF34 


«7800F4* 



M?H 



M?b? 



M?C2 



M?C3 



LH 


14»M?C0 


RC 


15iM?L 


MVI 


M?("N+2» 1 


MVI 


M?CN+5#1 


HC 


3b»M?L 


MVI 


M?CN+2»0 


HC 


lb»M?L+6 


WVI 


M?CN+3»2 


RC 


lb»^?Cl 


LH 


13»60 


LH 


]b» M ?CO+? 


CLC 


0(P»13) ,M?CN+8 


RC 


b.^?Cl 


AI 


62»18 


AI 


56»8 


PC 


1^'PCl 


CH 


13» M LNL» 


HC 


?^?C1 


CH 


i b»w?crj 


RC 


u»M?C3+8 


LH 


]4»58 


CLI 


M?CN+4»i 


RC 


R»M?C3+H 


MVI 


M?CN+4rl 


MVI 


^pPW+lUfX'f'F' 


MVC 


M?PW+2*+( ] 3P-26' »M?PW+b 


TR 


M?PW(132) »M?Tb-238 


TIO 


M?CN+6»3 


RC 


?rM?L+b 


TM 


f?CN+b»X 'F Q ' 


RC 


b»m?ko 


MVI 


w?CN+2» 1 


RC 


1b»M?t 


CLI 


M?CN+b»l 


RC 


fl>*+22 



SET BEGINNING ADDR TO IPP, P MD 6040 

GO TO L B MD 6050 

SET VC RO TO R2 p MO 606" 

SET VC KO T'"> K2 P MD 6071 

GO TO L B MO 6080 

SfrT VC RO TO Pl P MD 6091 

GO TO TT R MD 6100 

SET VC CO Tn C3 P MD 6110 

GO TO CI R MD 612" 

LOAD P17 FR"M RIU P MD M31 

PP SET ST. ADDRESS OF ^njT P MD 6140 

QQ IS DATA EQUAL TQ PRED? DY MD 6150 

IF MO GO TO CI C MO 6160 

Rib + 1« TO Rib P MD 6170 

R13 +8 TO R13 P MD 6180 

IF R13 OVERFLOW GO TO CI DM MD 6190 

IS P13 EQUAL TO. MEM LIMIT? DM MD 6200 

IF YES GO TO CI C MO 701O 

IS »15 EQUAL TO EDIT LI M TT? DY MD ">021 

IF MO GO TO QO C MD 7031 

LOAD R1U FROM R13 P MD 7040 

FO IS VC PO SET TO F?? DM MD 7050 

IF YES GO TO PP C MD 706O 

Fl SET VC FO TO F? P MD 7070 

FILL * INTO STANDBY P MD 7080 

PRIMT SUFFE" ARFA C MD 7090 

TRANSLATE P MD 7100 

TT TEST I/O STATUS P MO 7110 

IS PRINTER WORKING? DM MD 7120 

IS THFRE ANY ERROR? DY MO 7130 

IF MO GO TO VC KO C MD 7140 

SET VC RO TO P2 P MD 7150 

GO TO E B MO 7160 

IS VC KO SET TO K2? DM MO 7170 

IF YES GO T 1 " 1 K2 C MO 7180 



Figure 3—1. Example of Printer Output of a Program 

(Sheet 4 of 5) 



oi<4i 


0F38 


95020F6F 


0142 


0F3C 


47800F52 


0143 


0F40 


n2830080nF7A 


0144 


0F46 


47F00DF2 


0l4b 


0F4A 


92020F6K 


0146 


0F4E 


47F00F40 


0147 


0F52 


923C0050 


0148 


0F56 


A4030003 


0149 


0F5A 


ft*j030F7U 


OlbO 


UF5E 


U7200F5A 


Olbl 


0F62 


A90U2FFF 


OlbZ 


0F66 


47FU0UDA 


0lb3 


0F6A 




0lb4 


0F7A 




0155 




OOOOOAOgODUA 





CLI 


M?CN+5»2 




BC 


B»M?K3 


M?K1 


MVC 


128(132) »M?PW 




BC 


15»M?A 




MVI 


M?CN+b»2 




BC 


15»M?K1 


M?K3 


MVI 


B0pX»3Ct 




XIOF 


3»3 




TIO 


M?CN+6»3 




BC 


2»*-4 




HPR 


X'2FFF»,0 




BC 


15»MtNT 


M?CN 


OS 


CL16 


M?PW 


OS 


CLI 32 




END 


WENT 



IS VC KO SET TO K3? 

IF YES GO TO K3 

UOAO DATA INTO PRINT BUFFER 

60 TO A 

K2 SET VC KO TO K3 

GO TO Kl 

SET LINE ADV BITS FOR H.P. 

AND PAPER FEED TO H.P. POS 

IS PRINTER WORKING? 

IF YES REPEAT TIO 

SUCCESSFUL STOP 

RETURN TO MENT 

WS FOR VC AND PREOEC. B*TES 

STANDBY PRINT BUFFEP ARFA 



ON 


MD 


7190 


C 


MO 


7200 


P 


MD 


8010 


B 


MO 


8020 


P 


MO 


8030 


B 


MD 


8040 


P 


MD 


8050 


C 


MD 


8060 


DM 


MD 


8070 


C 


MD 


8080 


H 


MD 


8090 


B 


MO 


«10n 




MO 


8110 




MO 


812* 




MD 


813" 
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3.1.6. Assembler Control Card 

On the first pass, the source code deck may be preceded by a control card which 
has the following form: 



LABEL 



OPERATION 



CTL 



OPERAND 



ABS , p, q 



where ABS indicates the output element is to be in absolute code form and is not 
to contain any external reference, p is a decimal number representing the largest 
address available on the computer on which the assembly is being done, and q 
is a decimal n umber representin g the largest address available on the computer 
for which the element is being assembled. Any field in the operand may be omitted. 
If ABS is omitted, the output element is in relocatable code form. If p is omitted, 
the memory size of the computer on which the element is being assembled is 
assumed to be 16,384. If q is omitted, the memory size of the computer for which 
the element is being assembled is assumed equal to the memory size of the computer 
on which the assembly is being done. The CTL card may be omitted, in which case 
the result is the same as indicated for each field omitted. 

3.1.7. Operand Format 

In general, operands take the format of a series of expressions separated by commas. 
If an expression is not expressed, the comma indicating its position must never- 
theless be present. An exception to this rule is the last expression in the operand 
— if it is not expressed, its preceding comma may also be dropped. 

3.2. SYSTEM CODES 

Table 3 — 1 shows the relation the Assembler assumes between card code, internal 
computer code, and printer graphic. The Assembler reads a source code card in com- 
pressed form and then translates it to the internal code shown in Table 3—1. If keypunch 
equipment is used which sets up a different relationship between card code and printer 
graphic than the one shown in Table 3—1, a different translation table may be substituted 
at linker time for use by the Assembler in translating source code cards. This translation 
table may set up any relation between card code and printer graphic that is desired; 
however, the relation between internal code and printer graphic shown in Table 3—1 
must remain inviolate, since this is the only way the Assembler can "read" the source 
code. The Assembler prints its listing directly from the internal code. This operation, 
in effect, assumes a 63-character print bar. If a 48-character print bar is used while 
assembling, the Assembler may be modified at linker time to translate printer output 
from internal code to 48-character print bar code before printing. 

The Assembler punches all output cards in a compressed "object code" form which 
may be handled directly by the Linker or the absolute loader. 
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Some users may provide programs via the Assembler to be used to process data rep- 
resented in an internal code different from the one used by the Assembler. In such a 
case, the user must take special care in the representation of his constants. For 
example, the Assembler assigns the internal code 11000001 to the graphic "A". If, 
at the time an object program is run, the internal code for the data assigns the code 
11000000 to the graphic "A", a test for equality against a constant represented as 
C'A' in source code language may not be performed as desired. 

In general, when data to be processed by an object program is represented in an in- 
ternal code other than that used by the Assembler, all difficulties can be avoided 
by representing all constants in the source code in hexadecimal. 



TWO MOST SIGNIFICANT BITS OF ZONE - 00 





TWO LEAST SIGNIFICANT BITS OF ZONE 




bIGIT 


, 


, ■ 














00 


01 


10 


11 


0000 


12-0-9-8-1 


12-11-9-8-1 


11-0-9-8-1 


12-11-0-9-8-1 


0001 


12-9-1 


11-9-1 


0-9-1 


9-1 


0010 


12-9-2 


11-9-2 


0-9-2 


9-2 


0011 


12-9-3 


11-9-3 


0-9-3 


9-3 


0100 


12-9-4 


11-9-4 


0-9-4 


9-4 


0101 


12-9-5 


11-9-5 


0-9-5 


9-5 


0110 


12-9-6 


11-9-6 


0-9-6 


9-6 


0111 


12-9-7 


11-9-7 


0-9-7 


9-7 


1000 


12-9-8 


11-9-8 


0-9-8 


9-8 


1001 


12-9-8-1 


11-9-8-1 


0-9-8-1 


9-8-1 


1010 


12-9-8-2 


11-9-8-2 


0-9-8-2 


9-8-2 


1011 


12-9-8-3 


11-9-8-3 


0-9-8-3 


9-8-3 


1100 


12-9-8-4 


11-9-8-4 


0-9-8-4 


9-8-4 


1101 


12-9-8-5 


11-9-8-5 


0-9-8-5 


9-8-5 


1110 


12-9-8-6 


11-9-8-6 


0-9-8-6 


9-8-6 


1111 

■ 


12-9-8-7 


11-9-8-7 


0-9-8-7 


9-8-7 
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TWO MOST SIGNIFICANT BITS OF ZONE - 01 





TWO LEAST SIGNIFICANT BITS OF ZONE 




DIGIT 








00 


01 


10 


11 


0000 


B 


12 

& 


11 


12-11-0 


0001 


12-0-9-1 


12-11-9-1 


0-1 

/ 


12-11-0-9-1 


0010 


12-0-9-2 


12-11-9-2 


11-0-9-2 


12-11-0-9-2 


0011 


12-0-9-3 


12-11-9*3 


11-0-9-3 


12-11-0-9-3 


0100 


12-0-9-4 


12-11-9-4 


11-0-9-4 


12-11-0-9-4 


0101 


12-0-9-5 


12-11-9-5 


11-0-9-5 


12-11-0-9-5 


0110 


12-0-9-6 


12-11-9-6 


11-0-9-6 


12-11-0-9-6 


0111 


12-0-9-7 


12-11-9-7 


11-0-9-7 


12*11-0-9-7 


1000 


12-0-9-8 


12-11-9-8 


11-0-9-8 


12-11-0-9-8 


1001 


12-8-1 


11-8-1 


0-8-1 


8-1 


1010 


12-8-2 


11-8-2 
i 


12-11 


8-2 


1011 


12-8-3 


11-8-3 
$ 


0-8-3 

t 


8-3 

# 


1100 


12-8-4 


11-8-4 


0-8-4 


8-4 




< 


* 


% 


@ 


1101 


12-8-5 

( 


1 1-8-5 
) 


0-8-5 


8-5 
i 


1110 


12-8-6 


11-8-6 


0-8-6 


8-6 




+ 


f 


> 


= 


mi 


12-8-7 


11-8-7 


0-8-7 


8-7 




1 


~1 


? 


u 
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TWO MOST SIGNIFICANT BITS OF ZONE - 10 







TWO LEAST SIGNIFICANT BITS OF ZONE 




DIGIT 








00 


01 


10 


11 


0000 


12-0-8-1 


12-11-8-1 


11-0-8-1 


12-11-0-8-1 


0001 


12-0-1 


12-11-1 


11-0-1 


12-11-0-1 


0010 


12-0-2 


12-11-2 


11-0-2 


12-11-0-2 


0011 


12-0-3 


12-11-3 


11-0-3 


12-11-0-3 


0100 


12-0-4 


12-11-4 


11-0-4 


12-11-0-4 


0101 


12-0-5 


12-11-5 


11-0-5 


12-11-0-5 


0110 


12-0-6 


12-11-6 


11-0-6 


12-11-0-6 


0111 


12-0-7 


12-11-7 


11-0-7 


12-11-0-7 


1000 


12-0-8 


12-11-8 


11-0-8 


12-11-0-8 


1001 


12-0-9 


12-11-9 


11-0-9 


12-11-0-9 


1010 


12-0-8-2 


12-11-8-2 


11-0-8-2 


12-11-0-8-2 


1011 


12-0-8-3 


12-11-8-3 


11-0-8-3 


12-11-0-8-3 


1100 


12-0-8-4 


12-11-8-4 


11-0-8-4 


12-11-0-8-4 


1101 


12-0-8-5 


12.11-8-5 


11-0-8-5 


12-11-0-8-5 


1110 


12-0-8-6 


12^11-8-6 


11-0-8-6 


12-11-0-8-6 


mi 


12-0-8-7 


12-11-8-7 


11-0-8-7 


12-11-0-8-7 
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18 



TWO MOST SIGNIFICANT BITS OF ZONE - 11 





TWO LEAST SIGNIFICANT BITS OF ZONE 


DIGIT 












00 


01 


10 


11 


0000 


12-0 


11-0 


0-8*2 







0001 


12-1 
A 


11-1 
J 


11-0-9-1 


1 

1 


0010 


12-2 
B 


11-2 
K 


0-2 
S 


2 

2 


0011 


12-3 
C 


11-3 

L 


0-3 
T 


3 

3 


0100 


12-4 
D 


11-4 
M 


0-4 
U 


4 

4 


0101 


12-5 

E 


11-5 
N 


0-5 
V 


5 

5 


0110 


12-6 

F 


11-6 
O 


0-6 
W 


6 

6 


0111 


12-7 
G 


11-7 
P 


0-7 
X 


7 

7 


1000 


12-8 
H 


11-8 
Q 


0-8 
Y 


8 

8 


1001 


12-9 
1 


11-9 
R 


0-9 

Z 


9 

9 


1010 


12-0-9-8-2 


12-11-9-8-2 


11-0-9-8-2 


12-11-0-9-8-2 


1011 


12-0-9-8-3 


12*11-9-8-3 


11-0-9-8-3 


12-11-0-9-8-3 


1100 


12-0-9-8-4 


12-11-9-8-4 


11-0-9-8-4 


12*11-0-9-8-4 


1101 


12-0-9-8-5 


12-11-9-8-5 


11-0-9-8^5 


12-11-0.9-8-5 


1110 


12-0-9-8-6 


12-11-9-8-6 


11-0-9-8-6 


12-11-0-9-8-6 


nil 


12-0-9-8-7 


12-11-9-8-7 


11-0-9-8-7 


12-11-0-9-8-7 
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4. OPERATING PROCEDURES 



4.1. GENERAL OPERATING INSTRUCTIONS 

A source code deck ready for assembly must pass through the computer twice. The 
Assembler Load deck marked FIRST PASS precedes the source code deck on the first 
pass; the Assembler Load deck marked LAST PASS precedes the source code deck on 
the second pass. 

All printing and punching is done during the second pass. Consequently, the second 
pass may be repeated as often as required. The LAST PASS Assembler Load deck 
must precede the source code deck each time. When the card reader is used for input, 
feed the first card, then depress the PROC CLEAR and START keys. 

In addition to the regular I/O displays listed in Appendix B, the following displays 
may be used. 



DISPLAY 



1F02 



1FFF 



REASON AND ACTION 



Symbol table is full. 

Use larger memory size if possible (specification p on the CTL 
card) and start over. When p is 8191, the Assembler can handle 
about 200 tags. Press RUN to continue (all subsequent tags 
will be undefined). 

LAST PASS is completed. 

Two blank cards must follow the END card on the LAST PASS 

in order to get this display. 



4.1.1. Card Controller Operating Instructions 

The following sections provide instructions for operating the Card Assembler when the 
UNIVAC 1001 Card Controller is being used as the input device. Instructions are given 
for starting the run from the beginning, and for rerunning the second pass. 

4,1.1.1. Start Instructions 

To start the Assembler, perform the following steps: 

1. Place the source code between the FIRST PASS and LAST PASS load decks. 

2. Place the entire deck in the Card Controller primary read, hopper. 

3. On the Card Controller: 

a. Set ALT1 to the ON position; set all other ALT switches to the OFF position. 

b. Depress the LOAD PR1, CLEAR, START and RUN switches. 

4. On the UNIVAC 9200/9300 console: 

a. Enter hexadecimal B8 in the DATA ENTRY switches. 

b. Press the CHAN CLEAR, PROC CLEAR, LOAD ON, RUN, LOAD OFF, 
and RUN switches. 



5. On the Card Controller, set ALT1 to the OFF position. 



UP-4092 
Rev. 2 



UNIVAC 9200/9300 
CARD ASSEMBLER 



Rev. 1 



SECTION: 



4.1.1.2. Second Pass Rerun Instructions 

To rerun the second pass of the Assembler, perform the following steps: 

1. On the Card Controller: 

a. Place the LAST PASS load deck, followed by the source deck, into the 
primary feed hopper. 

b. Set all ALT switches to the OFF position. 

c. Press the LOAD PR1, CLEAR, START, and RUN switches. 

2. On the UNIVAC 9200/9300 console, press the CHAN CLEAR, PROC CLEAR, anc 
RUN switches. 

4.2. ASSEMBLER CARD OUTPUT 

The object code produced by the Assembler is punched into six different card types: 
Element Definition Cards, External Definition Cards, Program Reference Cards, Ex- 
ternal Reference Cards, Text Cards, and Transfer Cards. These card types have the 
following functions: 

■ The Element Definition Card contains the name, the size, and the origin of the 
element as assigned by the Assembler. 

■ An External Definition Card specifies the value of a symbol which may be refer- 
enced by other elements. 

■ The Program Reference Card contains the name of the element and the number by 
which this name is identified in the relocation information for the element. 



■ An External Reference Card contains a label to which the element refers but which 
it does not define. The card also contains a number by which this label is identified 
in the relocation information for the element. 

■ A Text Card contains the instructions and constants of the element, an address in- 
dicating where the instructions and constants are to be loaded into memory for 
execution, and the relocation information pertaining to the instructions and con- 
stants. The loading address for the instructions and constants is assigned by the 
Assembler to conform with the origin of the element as described in the Element 
Definition Card. The relocation information performs two functions: 

— It permits the relocation of the instructions and constants to an origin other 
than the one given to the element by the Assembler. 

— It provides the information required by the Linker to resolve any external ref- 
erences made in the instructions or constants with the corresponding external 
definitions made in other elements. 
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■ The Transfer Card is generated by the END assembler directive. If the END direc- 
tive specifies the address at which execution is to begin, this address appears in 
the Transfer Card. 

The order and number of these cards in the Assembler object code output deck is as 
follows. First there is a single Element Definition Card. Then there are as many Ex- 
ternal Definition Cards as there are ENTRY assembler directives in the source code. 
Then there is a single Program Reference Card followed by as many External Refer- 
ence Cards as there are EXTRN assembler directives in the source code. Then there 
are as many Text Cards as are required to contain the instructions and constants repre- 
sented in the source code deck. Finally, there is a single Transfer Card. 

If the output of an assembly contains no External Reference Cards, it may be loaded 
directly into the UNIVAC 9200/9300 via the Card Program Loader. In this instance, 
the text is loaded at the addresses indicated in the Text Cards, and job execution 
begins at the point indicated in the Transfer Card. The Element Definition Card, any 
External Definition Cards, the Program Reference Card, and the relocation information 
in the Text Cards are ignored by the Program Loader. 

The format of these assembler output cards is as follows. 

4.2.1. Element Definition Card 



COL. 


FIELDNAME 


CONTENTS 


1 


Load Key 


12-2-9 punch 


2 


Type 


A (Hollerith) 


3 


Length 


26 


6 


Absolute/relocatable 


12 punch if absolute program, relocatable otherwise. 


7 


Hole Count 


Sum of the bytes punched in columns 8-72. 


8 


ESID 


External Symbol Identification assigned by the 
Assembler to the name in columns 17-24. 


13-16 


Start Address 


The base of this element as assigned by the 
Assembler. 


17-24 


Name 


The name assigned to this element. (The name is 
left justified and is punched in EBCDIC.) 


33-36 


Length 


The number of bytes of memory needed by the 
relocatable portions of this element. 
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4.2.2. External Definition Card 



COL. 


FIELD NAME 


CONTENTS 


1 


Load Key 


12-2-9 punch 


2 


Type 


H (Hollerith) 


3 


Length 


13 (or number of columns used less one from Col. 11). 


7 


Hole Count 


Sum of the bytes punched (columns 8-72). 


9 


RLD Length 


Number of columns of RLD information on card (indi- 
cates 3 or 0). 


10 


Last RLD 


Column 11 relative number indicating the most signifi- 
cant column of the last item of RLD information on the 
card. The value is 59 if there is relocation data; other- 
wise zero. 


14-16 


Symbol address 


The Assembler assigned value of the symbol field. 


17-24 


Symbol 


Symbolic name to be referenced by other program(s) 
(punched in EBCDIC). 


70-72 


RLD 


Relocation field. See the description of this field for 
the Text Card. If present, column 72 contains a 3 and 
the least significant digit of column 71 also contains 
a 3 indicating that columns 14-16 are to be modified. 



4.2.3. Program Reference Card 



COL. 


FIELD NAME 


CONTENTS 


1 


Load Key 


12-2-9 punch 


2 

i 


Type 


J (Hollerith) 


3 


Length 


13 (or number of columns used less one from Col. 11). 


7 


Hole Count 


Sum of the bytes punched (columns 8-72). 


8 


Program ESID 


External Symbol Identification assigned by the 
Assembler to the program name. 


13-16 


Assembled Start Address 


The base of this program as assigned by the Assembler. 


17-24 


Name 


Element name (same as columns 17-24 of the 
Element Definition Card). 
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4.2.4. External Reference Card 



COL. 


FIELD NAME 


CONTENTS 


1 


Load Key 


12-2-9 punch 


2 


Type 


K (Hollerith) 


3 


Length 


13 (or number of columns used less one from Col. 11). 


7 


Hole Count 


Sum of the bytes punched (columns 8-72). 


8 


Name ESID 


External Symbol Identification assigned by the 
Assembler to this symbolic name. 


17-24 


Name 


Symbolic name being referenced by this card 
(punched in EBCDIC). 



4.2.5. Text Card 



COL. 


FIELD NAME 


CONTENTS 


1 


Load Key 


12-2-9 punch 


2 


Type 


Q (Hollerith) 


3 


Text Length 


Indicates the number of columns less one of text 
information on the card. 


4-6 


Load Address 


The Assembler assigned location where the text is 
to be loaded. 


7 


Hole Count 


Sum of the bytes punched (columns 8-72). 


8 


Program ESID 


External Symbol Identification assigned by the 
Assembler to the program name to which this load 
address is relative. 


9 


RLD length 


Number of columns of RLD information on this card. 


10 • 


Last RLD 


Column 11 relative number indicating the most 
significant column of the last item of RLD informa- 
tion on the card. This number is 59 if there is RLD 
data, otherwise zero. 


11 


TXT 


The value to be loaded at the load address. The TXT 


8» following 




field contains information from columns 11 through 
11 + n, where n is the number contained in column 3. 


72 


RLD 


RLD fields begin in column 72 and occur from right 


& preceding 




to left on the card for the number of columns indicated 
in column 9. Each RLD field is composed of three 
columns. 



Example of RLD field: 



Column 70 contains a name ESID. This points to a value in the linker reference 
table to be applied to the TXT on this card. 
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Column 71 contains a flag. The four most significant bits indicate the operation. 
All zero bits indicate that the reference table value is to be added to 
the text value to obtain the new text value. If the four most significant 
bits of the flag column are 0001, the reference table value is subtracted 
from the card text value to obtain the new text value. 

The three least significant bits of the flag column indicate (in binary) 
the length of the text field in bytes. The remaining bit is a one if the 
field to be modified contains an additional halfbyte. Thus, the four 
least significant bits would contain the value eight for a four-bit field. 
If all four bits are zero, the field is four bits long and is in the left 
halfbyte. 

Column 72 contains column position. A binary number (relative to column 11) point- 
ing to the most significant column of the text information to be modified,, 
(Column 11 is numbered as zero, column 12 as one, and so on.) 

4„2.6. Transfer Card 



COL. 


FIELD NAME 


CONTENTS 


1 


Load Key 


12-2-9 


2 


Type 


Y (Hollerith) 


3 


Length 


5 (or number of columns less one from Col. 11). 


7 


Hole Count 


Sum of the bytes punched (columns 8-72). 


9 


RLD Length 


Number of columns of RLD information on the card. 
(Indicates 3 or 0.) 


10 


Last RLD 


Column 11 relative number indicating the most signi- 
ficant column of the last item of RLD information on 
the card. (Contains 59 if there is relocation data, 
otherwise 0.) 


11-13 


Card Count 


The number of reference type K or text type Q cards 
which were produced by the assembler for this element. 
(Carried in binary.) 


14-16 


Start Address 




70-72 


RLD 


Relocation field. Column 72 contains column 11 
relative indicator of the first column of the start 
address (indicates Col. 14). The most significant 
4 bits in column 71 are 0001 if the reference table 
address is to be subtracted from the card start address 
or 0000 if the reference table address is to be added 
to the card start address to obtain the relocated start 
address. The least significant 4 bits in column 71 
indicate that the start address on the card is 3 bytes 
long. Column 70 contains the ESID that points to the 
value in the reference table to be applied to the card's 
start address field. 



For all assembler output cards, the PID is left justified in columns 73-76, and a 
sequence number is punched in columns 77-80. Both the PID and sequence number 
are punched in Hollerith. 
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4.3, CARD ASSEMBLER PRINTED OUTPUT 

The first page printed during assembly is a list explaining the one-character error 
codes that may occur on the succeeding assembly listing. Up to five of the codes may 
appear on one line in the assembly code field. The assembly listing contains the 
following: 



PRINT POSITION 


FIELD 


0-3 


Assembler assigned line number 


4-8 


Assembly codes 


10-13 


Assembler assigned address of the object code 




or (in the case of an EQU or an ORG line) the 




value assumed by the assembler. 


15-46 


Assembler produced object code (in hexadecimal). 


48-127 


Input card 



The error codes and their meanings are as follows: 

C Cover error, no USING covering relocatable operand address. 

D Doubly defined label or reference to doubly defined label. 

E Expression too large or improper syntax. 

H Halfword boundary error on RX or AI operand. 

I Instruction error. 

L Location counter too large. 

O Org error, 2nd definition of a label. 

R Relocatable terms in the expression are improper or too many. 

S Sequence break in columns 76 to 80. 

T Truncation of oversize term. 

U Undefined label referenced in this line. 

X Continuation (no blank col 72 on noncomment card)-not permitted. 



UP-4092 
Rev. 2 



UNIVAC 9200/9300 
CARD ASSEMBLER 



4.4. LINKING THE CARD ASSEMBLER 

The source code for the Assembler consists of nine elements. From these elements 
the Linker produces three phases. 

The first phase (having 1 punched in column 77) is the Assembler's FIRST PASS. 

The second and third phases together (having 2 or 3 punched in column 77) become the 
Assembler's LAST PASS. 

The example shown below would produce a card assembler for the following machine 
configuration: 

Standard card reader 

Serial punch 

Standard printer/63 character print bar 



LINKER INPUT 


LINKER OUTPUT 


CTL 2,16383,16383 




PHASE A91,510,A 




RDTT EQU 0,TBRD 




PRTT EQU 0,TBRD 




BLNK EQU 64 




PRTR EQU 15 




FONT EQU 




TBPR EQU 




Loader module (LD) 


^ 


Punch module (XPCH) 




Reader module (XRDR) 


► PHASE1 A91 - First Pass 


Printer module (XPRT) 




Read translate table module (TBRD) 


> 


Assembler first module (FIRP) 


PHASE A92,0,L,INTF 




Assembler second module (MIDP) 


\ PHASE2 A92. 


Punch translate table module (TBPU) 
PHASE A93,0,L,INTF 


> Last Pass 


Assembler third module (LASP) - 


PHASE3 A93 ' 


END 
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In order to produce an assembler for a machine configuration using a row punch instead 
of a serial punch: 

■ Substitute an XPRW module for the XPCH module. 

■ After the first phase card, place the following card: 



LABEL 


OPERATION 


OPERAND 


CHNL 


EQU 


n 



where: n is the channel number of the row punch. 

In order to make an assembler that would use a UNIVAC 1001 Card Controller instead 
of the standard card reader: 

■ Substitute an XRDC module for the XRDR module. 

■ Substitute an LDCC module for the LD module. 

■ Change the second parameter of the first phase card from 510 tc 600. 

■ Include an EQU card of the following format: 



LABEL 


OPERATION CODE 


OPERAND 


RDCN 


EQU 


n 



where: n is the number of the channel in which the Card Controller is located. 
In order to make an assembler that would print on a 48 character bar: 

■ Substitute PRTT EQU 0, TBPR for PRTT EQU 0, TBRD. 

■ Substitute BLNK EQU 16 for BLNK EQU 0. 

■ Substitute PRTR EQU for PRTR EQU 15. 

■ Substitute FONT EQU 128 for FONT EQU 0. 

■ Remove TBPR EQU 0. 



Include the print translation table module (TBPR) immediately after the XPRT 
module. 
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5. LINKER 



5.1. INTRODUCTION 

When a job consists of more than one element, the elements, which are the output of sep- 
arate Assembler runs, must be combined before they may be loaded as an executable object 
program. This combining, or linking, is done by a utility program called the Linker. The 
Linker inserts the storage addresses for references made from one element to another and 
modifies addresses if an element is relocated. 

A provision is included for dividing the output elements into separate loads or "phases". 
Another provision allows corrections, stated in hexadecimal, to be made to any of the 
elements being linked. These corrections must be in terms of the ultimate absolute addresses 
assigned to each field being changed. 

Most of the input to the Linker consists of the output of one or more Assembler runs. How- 
ever, control cards are supplied by the user to specify: 

— the initial storage address to be allocated to the output element 
(PHASE card) 

— the start of a new phase of the output (PHASE card) 

— additional external definitions (EQU card) 

— corrections to one or more of the elements being linked (REP) 

— the end of the input stream (END) 

The Linker provides an output listing including: 

— the control cards on its input, 

— the names and external definitions of the elements being linked and 
the values allocated to each, as well as the number of the phase in 
which it is included. Phases are numbered consecutively from one in 
the order in which they appear in the input. 

Error indications are included in the listing, and most errors cause termination of the 
punched output. The punched card output is in the same form as the assembler output 
cards, except that no relocation data is punched. The output for each phase consists of 
Text Cards and a Transfer Card. 

If necessary, the Linker increments the address to be assigned to each input element so 
that the base address is a multiple of four. 

The Linker is capable of either a one- or two-pass operation. At the end of pass one a stop 
occurs with a display indicating readiness for pass two. At the end of pass two a stop 
with a display requiring a reply occurs. When the start button is depressed, the Linker 
interrogates this reply to determine its subsequent action, which is to process another 
set of input or to terminate processing. 
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The Linker is assembled separately from its input/output but is linked to the input/output, 
allowing for input from the standard card reader or the UNIVAC 1001, output to serial or 
row punch, and choice of input translation table and the dption of a translation for the 
48-character printer. 



5.2. LINKER INPUT 

The major input to the Linker consists of the output of one or more assemblies. The 
input to the Linker is normally formed by placing one element behind the other in 
the order they are to have in storage. Then a PHASE card is placed at the beginning 
of the deck to define the initial storage location and an END card at the end to signal 
the end of the input. If the output element is to consist of more than one phase, each 
input element must be entirely in one phase, with a PHASE card inserted in front of 
the first Element Definition Card in the phase. Each such PHASE card indicates the 
initial address to be allocated to that phase. When the Linker input is arranged in this 
manner, all elements comprising one phase must follow the PHASE card defining that 
phase and precede the PHASE card defining the next phase. Each element in the 
input must have a unique name. 

The order of the input must also be such that the element using an externally defined 
symbol must precede all elements referring to that symbol. If there are any symbols 
for which this is not possible, their definitions may be supplied by EQU cards. If 
this is not desirable, the Linker provides the option of a two-pass operation. The 
first pass recognizes the headers (Element Definition and External Definition Cards) 
and stores the external definitions. The second pass processes the External Ref- 
erence, Text, and Transfer Cards, and produces the output element. 

If desired, a two-pass operation may be avoided by separating the headers of the 
input elements and presenting them first. The procedure is as follows: 

1. Put together the input elements as described above, but without 
control cards; 

2. Sort out the header cards (12 punch in column 2); 

3. Place the header cards in front of the remaining deck; 

4. Insert the required control cards. 

Each PHASE card should precede the Element Definition Card for the first element 
in the phase being defined. EQU cards follow a PHASE Card, Element Definition, or 
External Definition Cards. REP cards must immediately precede the Transfer Card of 
the element they are to alter. 

The Linker ignores the presence of any blank cards in its input deck. 

5.3. LINKER CONTROL CARD FORMATS 

The control card identifier (CTL, PHASE, EQU, REP, or END) is left justified in 
columns 10-14. Columns 1 to 9 are blank except for the EQU card on which columns 
1 to 4 contain the symbol being defined. The specifications contained on each control 
card begin in column 16 and are terminated by a blank. 
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5.3.1. CTL 



The CTL card is the first card of the Linker input The specifications consist of 
three fields separated by a comma: 

n,p,q 

where n=l is a one-pass operation of the Linker; 

n=2 is a two-pass operation of the Linker; 

p is a decimal number representing the largest address available during 
linking. 

q is a decimal number representing the largest address available to the 
output element. 

Any field may be omitted. The effect is as follows: 

n omitted : one-pass operation. 

p omitted : largest address available for linking is not to change. The 
initial value is 16383. 

q omitted : maximum address to be allocated is not to change. The initial 
value is 16383. 

The CTL card may be omitted, in which case the result is the same as indicated 
above for each field omitted. 

If the Linker is to perform a two-pass operation and produce code for a 16K system 
on a 16K system, the CTL card would be 

CTL 2,16383,16383 



5.3.2. PHASE 



A PHASE card defines the name and initial storage address for the output element 
and must be the first or second card of the Linker input, preceded only by the CTL 
card. A PHASE card also precedes the Element Definition Card (type A) for the 
first element of each subsequent load. It specifies the name of the phase and its 
starting address. 

The operand specifications field has the form 

phase-name, displacement, flag, symbol 

where phase-name is a group of up to four alphabetic characters representing the 
name of the phase 

displacement is a decimal number (may be preceded by minus) or a hexa- 
decimal number in the form X'nnnn' 
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flag 



symbol 



is C or A for the first PHASE card and C, A, or L for any others. 

C — load address equals the highest core address minus the 
displacement field. 

A — load address is the actual value given in the displacement 
field. 

L — load address is obtained by adding the displacement to the 
value of the symbol. 

is any previously defined symbol. 



5.3.3. EQU 



An EQU card supplies the definition of a symbol which is not defined in any of the 
elements being linked or which is defined in an element whose position in the input 
deck is later than that of the first element containing a reference to the symbol. 

The operand specification field of the EQU card has the form: 

value 



or 



value, symbol 



where value is a decimal number, a decimal number preceded by a minus sign, 
or a hexadecimal number in the form X'nnnn' 

symbol is any symbol which has been defined previous to the EQU card in 
the input deck. 

In the first form above, the binary value represented by the value field becomes the 
value assigned to the symbol appearing in the label field of the EQU card. For an 
EQU card with a specification field of the second form above, the value of the 
previously defined symbol is added to this value to yield the value of the symbol 
being defined. 

An EQU card must follow a PHASE card, an Element Definition Card, an External 
Definition Card, or another EQU card. It must precede the body of the first element 
containing a reference to the symbol defined. The symbol, contained in the specifi- 
cation field, must have been previously defined. 

If the Linker control deck contains more than one EQU card defining the same 
symbol, an error indication is made on the listing. However, such an error does 
not terminate the punching of output. Instead, the Linker continues to treat the 
definition given in the first such EQU card as the definition for the symbol. 



5.3.4. END 



The END card indicates the end of the input to the Linker and is the last card in 
the deck. 

The operand specification field has the same form as that of the EQU card, and is 
processed in the same way to produce a single value which is interpreted as the 
address at which to begin executing the last phase being produced by the Linker, 
as such, this value is punched into the Transfer Card at the end of the output 
element. 
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If the output of the Linker consists of more than one phase, the transfer address 
of each phase but the last is determined as follows: 

a. Normally, the transfer address of the phase is the address from the first 
Transfer Card in the input to the phase. 

b. If no Transfer Card in the input contains an address, the transfer address 
is the lowest address assigned to the phase. 

The specification field of the END card may also be blank. In this case the trans- 
fer address punched into the terminal Transfer Card of the output element is the 
address from the first Transfer Card of an input element in that phase containing 
an address. If no Transfer Card of an input element contains an address, the 
lowest address assigned to that phase is punched into the terminal Transfer Card. 



5.3.5. REP 



The REP (Replace) cards specify changes which are to be made to an assembled 
element. The REP cards are placed immediately in front of the Transfer Card of 
the element to be altered. Addresses and data are specified in hexadecimal in the 
same form they are to have in the output element. No relocation or linking, facilities 
are provided by the Linker for this data. 

The form of the operand specifications field is: 

address, data, data,... 



where: address 



data 



is a field of from one to four hexadecimal digits specifying the 
storage address of the leftmost byte of data to be altered as a 
result of this card. 

is a field of from one to four hexadecimal digits specifying data 
to be right justified in a halfword of storage. The address field 
is followed by a variable number of such data fields specifying 
the contents of successive halfwords of memory. The fields are 
separated by commas and terminated by a blank. 



5.3.6. MOD 



The MOD (modular set) card instructs the linker to set the location counter to the 
value calculated from the operand specifications. The operand specifications field 
has the following form: 

a, b 
where: a must be a power of 2, and may be a decimal or hexadecimal expression, 
b may be omitted, or it may be a decimal or hexadecimal expression. 

The location counter is set to the next number which is the value of "b" more than 
a multiple of the value of "a" and which is greater than or equal to its present value. 
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Examples: 



MOD 8 



If the present value of the location counter is 4024, then the value is not modified. 
If the current value is 4025, it is modified to 4032. 

MOD 8, 3 
If the current value of the location counter is 4028, its value is modified to 4035. 

The MOD card must be placed immediately before the object deck of a module. 

5.4. EXAMPLE 

Assume two separately assembled elements, A and B. A was assembled at an origin 
of and has a length of 100, while B was assembled at an origin of 400 and has a 
length of 200. Further, A externally defines one entry point M, which is assigned an 
element relative address of 50, and makes external references to symbols X, Y and 
Z. B on the other hand externally defines symbols X, Y, and Z and makes an external 
reference to M. Symbols X and Y are entry points with relative addresses of 475 and 
550, respectively, while Z is defined as having an absolute value of 25. Finally, 
neither the A nor the B element Transfer Card specifies a starting address. The object 
code decks for elements A and B have the following construction. 

Element A 

a. One Element Definition Card specifying that this element is named A and has an 
origin of and a length of 100. 

b. One External Definition Card specifying M as an externally defined symbol with 
an element relative value of 50. 

c. One Program Reference Card specifying that this element is named A, that this 
name has an External Symbol Identification (ESID) number of 1, and that element 
A has an origin of 0. 

d. Three External Reference Cards specifying that X, Y, and Z are externally ref- 
erenced symbols which have ESIDs of 2, 3, and 4, respectively. 

e. Text Cards containing the instructions and constants of element A and the re- 
location information for these instructions and constants. Two examples may 
clarify the nature of this relocation information: 

1. An instruction may refer to some other part of element A. This reference is 
relative to the origin of the element. If the origin moves, the reference must 
be adjusted accordingly. The associated relocation information indicates 
where this reference is made in element A and specifies the ESID of element 
A, indicating that this is an element relative reference. 

2. An external reference may be made. In this case, the reference is undefined. 
The associated relocation information indicates where in element A this 
reference is made and specifies the ESID identifying the undefined symbol 
referenced. 

f. One Transfer Card. 

Element B 

a. One Element Definition Card specifying that this element is named B and has an 
origin of 400 and a length of 200. 
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b. Three External Definition Cards. 

1. One specifies that X is an externally defined symbol and that it has an element 
relative value of 475. 

2. One specifies Y with an element relative value of 550. 

3. One specifies Z with an absolute value of 25. 

c. One Program Reference Card specifying that the element is named B, that it has 
an ESID of 1, and that it has an origin of 400. 

d. One External Reference Card specifying M as an externally referenced symbol 
with an ESID of 2. 

e. Text Cards containing the instructions and constants of element B and the re- 
location information for these instructions and constants. 

f. One Transfer Card. 

These two decks are represented schematically in Figure 5 — 1. Suppose elements A 
and B are to be linked into one job having an origin of 1000 and whose initial execu- 
tion address is to be the beginning of element A. The origin would be specified in a 
PHASE card, the transfer address in an END card. The input to the Linker for a one- 
pass operation would appear as shown in Figure 5—2. 

The Linker reads the PHASE card and sets the location counter to 1000 in preparation 
for creating a job to be loaded beginning at memory location 1000. The Linker then 
reads the header cards and sets up the reference table. Each entry in the reference 
table consists of three fields. 



1. The name which this entry describes. 

2. The location assigned to this name. 

3. The relocation factor for this name. The relocation factor is the amount by 
which the value assigned to the name by the Assembler must be adjusted to 
arrive at the value to be assigned to the name by the Linker. 
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Figure 5—1. Elements A and B Deck Structure 
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ELEMENT B 
BODY 



ELEMENT A 
BODY 




ELEMENT B 
HEADER 



ELEMENT A 
HEADER 



PHASE 



Figure 5-2. Linker Input 
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For example, the name "A" is to be assigned a value of 1000 by the Linker. It was 
assigned a value of by the Assembler; therefore, its relocation factor is 1000. 

As a second example, consider the name "B". 

1. Since element A begins in location 1000 and is 100 bytes long, the name 
"B" is assigned a value of 1100 by the Linker. 

2. While the body of element A is being processed, the name "B" has a 
relocation factor of 1100, since the name "B" is undefined in element A. 

3. While the body of element B is being processed, the name "B" has a 
relocation factor of 700, since in element B the Assembler assigned a 
value of 400 to the name "B". 

The reference table produced as a result of processing the header cards in Figure 
5—2 is shown in Figure 5—3. 

The Linker then reads the Program and External Reference Cards for element A. 
The information from these reference cards is used by the Linker to build an ESID 
table. Each entry in the ESID table consists of two fields: 

1. The ESID from the reference card. 

2. The reference table entry number of the symbol to which the ESID is 
assigned. 

The Program Reference Card is also used to determine the relocation factor for the 
element name. The result of processing the reference cards is shown in Figure 5-4. 

The Linker then processes the text of element A. For each instruction or constant 
on the input text cards it produces an instruction or constant on an output Text 
Card. The absolute portions of the text ate produced unaltered. The address at 
which the text is to be loaded is adjusted by the relocation factor for element A. 

If a portion of the text is relocatable, then there is associated with it relocation 
information specifying an ESID of 1. In this case, the Linker looks up in the ESID 
table the associated reference table entry number. It then looks up in the reference 
table the relocation factor (1000) and adjusts the text by the relocation factor. The 
input text is then relocated to the origin specified by the PHASE card, and this 
relocated text is produced as output. 



The Linker performs a similar function if a portion of the text makes an external 
reference. (Assume the reference is made to the symbol Y.) There is associated with 
this text relocation information specifying the ESID of the external reference (3). 
The text is adjusted by the relocation factor (1250) determined by the relation be- 
tween ESID and reference table entry number (5). This defines the external reference, 
and the resolved text is produced as output. 
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ELEMENT B 
BODY 



ELEMENT A 
BODY 




REFERENCE TABLE 
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Figure 5—3. Header Processing 
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ELEMENT A 
BODY 



ELEMENT B 
BODY 




ESID TABLE 
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ENTRY 
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Figure 5-4* ESID Processing for Element A 
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The Linker recognizes the end of element A by means of the Transfer Card. It then 
reads the Program and External Reference Cards for element B and adjusts the 
reference and ESID tables accordingly. The result of this adjustment is shown in 
Figure 5—5. Note that the relocation factor for the name "B" is changed. 

The Linker then uses the ESID and reference tables to process the text of element 
B and produces the related output text completely relocated and with all external 
references defined. In response to the END card, the Linker produces a Transfer 
Card with a value of 1000 (the value of the name "A") in it for a Transfer Address. 
Thus, the output of the Linker is a deck of Text Cards with no relocation information, 
followed by a Transfer Card. 

If a third element were to follow element B as input to the Linker, the relocation 
factor for the name "B" would be set back to 1100 by the Linker before it processed 
this third element. 
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Figure 5—5. ESID Processing for Element B 
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5.5. ONE- AND TWO-PASS LINKING 

One-pass linking of an input deck is possible when all symbols on.External Reference 
(type K) cards have been defined by some preceding Element Definition (type A), 
External Definition (type H), or EQU control card. 

When the definition of a symbol occurs after an External Reference to the symbol, a 
two-pass run is necessary. However, if the definitions are moved to the front of the 
deck, a one-pass run can then be made. The move is accomplished by sorting on a 
12-punch only in column 2 of the Assembler-produced cafds. All these definitions 
appear on Element Definition (type A) and External Definition (type H) cards which 
are at the beginning of an Assembler-produced element. Consequently, the cards can 
be easily stripped off by hand. 

For the first pass of a two-pass operation, the Linker object deck precedes the input 
deck in the input hopper of the card read unit. For the second pass, the input deck 
only is placed again in the input hopper. 

Figures 5—6 and 5-^7 illustrate the placement of control cards for a one- and two- 
pass linking operation. 

5.6. LINKING THE LINKER 

A new loadable Linker program is produced by combining the several separately 
assembled components of the Linker by means of a Linker run. The combined 
Linker occupies memory locations from the upper limits of privileged memory to 
approximately 1824. Memory addresses greater then 1824 are used by the Linker 
for ESID tables and the reference table. The Linker can thus handle, when oper- 
ating in 8K, approximately 200 external references during linking. 

Computers with larger memory capacities can handle an even greater number of 
external references. 
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Assembler Produced 
Elements 



Linker Input 



Linker Output 



Element Definition (A) 
External Definitions (H) 



Element \ Program Reference (J) 
A / External Reference (K) 



Text (Q) 



Transfer (Y) 



Element Definition (A) 
External Definitions (H) 



Element l Program Reference (J) 
B ) External Reference (K) 



Text (Q) 



Transfer (Y) 



Element Definition (A) 
External Definitions (H) 



Element l Program Reference (J) 
C /External Reference (K) 



Linker 
Object 
Deck 



Control 
Cards 



Text (Q) 



CTL 

PHASE (1) 
EQU 



Element 
A 



Element 
"K B 



Control Card - PHASE (2) 



■»>< Element 
C 



Control Card - END 





I PHASE 


" 


( (1) 


Transfer (Y) 




Text (Q) 


\ 


• 


f PHASE 




f (2) 


Transfer (Y) 


) 



Text (Q) 



Transfer (Y) 



Figure 5—6. Linker Input Deck Sequence for Two-Pass Operation 
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Assembler-Produced 
Elements 



type A 
type H 



type J 
Element ) type K 
A 



type Q 



type Y 



type A 
type H 



type J 
Element J type K 
B 



type Q 



type Y 



type A 
type H 



type J 
Element ] type K 
C 



type Q 



type Y 



Sort column 2 
(lock out all 
but 12 punch) 
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Linker Input 
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_ Deck 



Control 
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Element A 

Headers 

type A & H 



12 in / Element B 
Col. 2 ( Headers 
type A & H 



Element C 

Headers 

type A & H 





Element A 




Body 




\ type J,K,Q & Y 


12 in 


J Element B 


Col. 2 


\ Body 




J type J,K,Q, & Y 




1 Element C 




1 Body 




type J,K,Q & Y 
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Control 
Card 
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CTL 

PHASE(l) 
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type A 
type.H 



type A 
type H 



PHASE(2) 



type A 
type H 
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ype J 
ype K 



ype Q 



ype Y 



ype J 
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ype Q 



ype Y 



ype J 
ype K 



ype Q 



ype Y 
END 



Linker Output 

type Q 

PHASE 

(1) 



PHASE 

(2) 




type Y 



Figure 5—7. Linker Input Deck Sequence for One-Pass Operation 
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The Linker, as a program, has one phase. The PHASE control card used when the 
Linker is being linked with the Card Load Routine, LD, is as follows: 



Label 



Operation 



PHASE 



Operand 



LNKR,410,A 



The PHASE card, when linking with the Card Load Routine (LDCC), is: 



Label 



Operation 



PHASE 



Operand 



LNKR,500,A 



The EQU cards for the linking operation follow the PHASE card. 

The first element in the input deck must be the Card Load Routine. The program 
name for the routine is LD if the online card reader is used to load the Linker 
being linked. If the Card Controller is used, the name for the Card Load Routine 
is LDCC. 

The last element in the input deck must be the Linker element which has the pro- 
gram name, LNKR. The elements between the Card Load Routine and LNKR may 
be in any order. The elements are as follows: 

■ Exec I, which is named EXEC. 



Card Read Routine. This is generated from a call on either the DTFCR macro 
for the card reader or the DTFCC macro for the card controller. In either case: 

a. The "filename" must be RDR. 

b. CNTL=YES is not required. 

c. The MODE parameter is specified as MODE=CC. 

For DTFCR, the following are also required: 

a. SENT^NO 

b. IOAl^IOAl. 

For DTECC, specification of the CHAN parameter is also required. 
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Input Translation Table. The Linker reads input cards in compressed code. If it 
identifies a card as a control card, it must translate the card before processing 
it. To allow the user to punch control cards in any card code he wishes, the 
Linker uses a user-supplied translation table to effect the translation. The Linker 
assumes that the result of the translation is EBCDIC. The user-supplied input 
translation table must be labeled TRN. The Hollerith-to-EBCDIC translation 
table, labeled TBRD, supplied by the Univac Division, can be used when 
control cards are punched in Hollerith. In this case, the following EQU card 



LABEL 


OPERATION 


OPERAND 


TRN 


EQU 


O.TBRD 



should be included with the other EQU cards in the input deck. 

Card Punch Routine. This is generated from a call either on the DTFRP macro or 
on the DTFRW macro for the online serial read/punch or for the row read/punch, 
respectively. If the online serial read/ punch is used, the PUNR=YES parameter 
specification is made. If the row punch is used, the CHAN parameter must be 
specified. For both macros: 

a. The "filename" must be RPP. 

b. CNTL=YES is not required. 

c. The MODE parameter is specified as MODE=CC. 

d. The OUAR parameter is specified as OUAR = OUP. 

e. The TYPF=OUTPUT parameter specification is used. Therefore, the EOFA, 
INAR, ITBL, and ORLP parameters are not specified. 

f. The OTBL parameter is not required because Linker output is punched in com- 
pressed code. 

Printer Routine. This routine is generated from a call on the DTFPR macro. For 
this macro: 

a. The "filename" must be PRNT. 

b. The BKSZ parameter is specified as BKSZ=96. 

c. CNTL=YES is not required. 

d. PROV=YES is used. Consequently, a paper loop containing form overflow and 
home paper punches, at appropriate points, must be in the printer when the 
Linker is run. 
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e. The FONT parameter specified should agree with the print bar used in the printer 
during Linker execution. The OTBL parameter must be specified if a 48-character 
bar is used (FONT=48). In this case, an EBCDIC to 48-character print code trans- 
lation table must also be included in the Linker input deck. If the table TBPR, 
supplied by the Univac Division, is used, the OTBL=TBPR parameter must 

be specified when generating the printer routine. 

f. PRAD may be specified as one or two, as desired. 

The format for the END control card used when the Linker is being linked is as follows: 



Label 



Operation 



END 



Operand 



O, BEGN 



For convenience, blank cards may be used to separate elements in the input deck since 
the Linker ignores blanks. 

5.7. CARD OUTPUT FROM THE LINKER 

The Linker produces two types of output cards: 



Type (col. 2) 


Name 


Caused By 


Q 
Y 


Text card 
Transfer card 


Input Q cards or REP cards. 
See 5.3.4. 



5.7.1. Type Q Cards 

The Q cards contain the program in loadable absolute form. They are produced when 
enough contiguous input text is available to fill an output Text card, when text is not 
contiguous, or when a REP card is processed. An input program could consist of REP 
cards and no Q cards. This permits the programmer to write short programs in hexa- 
decimal to be linked without assembling. 

The format for a Q card is as follows: 



Type (Hollerith Q) 
Card Length 
Load Address 
Hole Count 
Absolute Program 



Column 2 

Column 3 

Column 5-6 

Column 7 

Column 11—72 (depending of column 3) 



5.7.2. Type Y Cards 



The Y cards occur as separators between the loadable phases (overlays) and at the 
end of the last phase. The Y cards cause the Loader to stop loading and to transfer 
control to the transfer address in the Y card. 
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The format for a Y card is as follows: 



Type (Hollerith Y) 

Card Length 

Hole Count 

Card Count of 
Preceding Phase 

Transfer Address 



Column 2 
Column 3 
Column 7 

Column 12-13 
Column 15-16 



NOTE: All Linker output cards have the first three characters of the program name 
(from the first input PHASE card) in column 73—75, a phase identification 
in columns 76 and 77, a serial number in columns 78—80, and a load key (12- 
2—9) in column one. The phases are numbered sequentially in hexadecimal. 
The program name and serial number are punched in Hollerith. 

5.8. LINKER MAP 

The Linker map is printed during a one-pass Linker run or during the second pass of 
a two-pass Linker run. The map contains a line for each Linker Control Card and for 
each of the following Assembler-produced cards: 



Card 


Card 


Generated in 


Type 


Name 


assembly by 


A 


Element Definition 


START Directive 


H 


External Definition 


ENTRY Directive 


J 


Program Reference 


START Directive 


K 


External Reference 


EXTRN Directive 


Y 


Transfer 


END Directive 



No line is printed for type Q (Text) cards. 

5.8.1. Linker Map Print Lines 

For a type A card, the printed line contains (in order from left to right) the load 
location, in hexadecimal, assigned to the element name, the card type identification 
code (A), the Assembler-assigned ESID number, the element start address, the 
element name, the element length, and the output phase (overlay) number. 

For a type H card the printed lines contain the value, in hexadecimal, assigned 
to the externally defined symbol, the card type identification code (H), the Assembler- 
assigned value of the externally defined symbol, and the name of the externally 
defined symbol. 
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For a type J card the printed lines contain the load location, in hexadecimal, 
assigned to the element name, the card type identification code (J), and the 
element name. On the line for the first type J card of a phase, the phase number 
is printed following the element name. 

For a type K card the printed lines contain the value assigned to the externally 
referenced symbol, the card type identification code (K), the Assembler-assigned 
ESID number, and the name of the externally referenced symbol. 

For the first type Y card following a PHASE card and containing a start address, 
the printed line contains the start address and the card type identification code. 

The type Q cards are not printed. For each input element, the type Q cards 
immediately precede the type Y card. 

At the left of each PHASE, EQU, and END control card line is printed the value 
specified on the card. For the PHASE control card, the value printed is the 
initial storage address as specified in the card. For the EQU card, the value is 
that of the symbol defined by the EQU card. For the END card, the value is the 
specified transfer address. 

If a line is flagged with an error message, the error message precedes the card 
type identification code. 



5.8.2. Linker Map Error Messages 
TBL END 



Too many external references for the combined table area to 
handle. 



SHORT 



NO SYMB 



UNEQU 



ESIDX 



NO DEF 



A PHASE card has missing information. The PHASE card may 
be partially processed by the Linker. Punching is discontinued. 

An undefined symbol was contained in the operand of a PHASE, 
EQU, or END card. Partial processing of the erroneous card may 
occur. Punching is discontinued. 

Label field (columns 1—4) on an EQU card was previously defined 
differently. The value printed on the left is the previously defined 
value. The new value is ignored. Punching continues-. 

The ESID number (column 8) on a type A card is not 01. The name 
is used by the Linker but values are not. Punching is discontinued. 

The symbol on a type J or K card was not defined by a type A 
(Element Definition) or type H (External Definition) card from 
assembly or by a manually entered EQU to the Linker. The card 
is partially processed by the Linker. Punching is discontinued. 
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EXT VAL 



C COUNT 



X 



The external value defined by an External Definition (type H) 
card is not equal to the value previously defined for the symbol. 
The value printed on the left is the previously defined value. 
The new value is ignored. Punching is discontinued. 

The card count on a Transfer (type Y) card does not agree with 
card count of the preceding element. Punching continues. 

An output load address has exceeded the object memory 
size specified by q of the CTL card. 



5.9. LINKER CONSOLE DISPLAYS 



DISPLAY 



REASON FOR STOP 



ACTION 



1F03 
1F04 

1F05 



1F06 



1F0F 
1FFF 



Invalid card type. 

After a Y card, no J card 
was found preceding the 
next K or Q input card. 

Input card hole count error. 



An external reference has 
been made to a label not 
defined by a K card. (The 
K card could have been lost 
or misplaced in the input 
deck.) 

First pass is finished. 

Last pass is finished. 



Press START to ignore card. 
Press START to ignore card. 



The card on which the error occurred is 
the second one from the top of the output 
stacker. To reread the error card, place 
it and all cards that follow it (including 
the card in the wait station of the reader) 
at the bottom of the deck in the input 
hopper, manually feed a card, and press 
the START button. 

Check the Linker map against the Assembly 
listing, re-order the card deck appropriately, 
and start the Linker operation over again. 



Press START to begin last pass.* 
Press START to begin new Linker run. 



* Note that, to start the last pass, the input deck must be removed from the hopper 
and once more placed in the input hopper. If the Card Controller is being used as 
the input device, at the end of the first pass the last two cards of the input deck 
are still in the device and must be run out by pressing the PRI UNLOAD button 
twice. 
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APPENDIX A. 



PREASSEMBLY 
MACRO PASS 



Al. GENERAL DESCRIPTION 

The Preassembly Macro Pass of the UNIVAC 9200/9300 Card System is used in conjunction 
with the Assembler to promote ease and efficiency in preparing programs for execution on 
the UNIVAC 9200/9300. A schematic of the Preassembly Macro Pass is shown in Figure 
A-l. 



MACRO 

INSTRUCTION 

DECK 




MACRO 
LIBRARY DECK 




V 



UNIVAC 
9200/9300 



SOURCE CODE 
DECK 
READY FOR 
ASSEMBLY 



ft 



Figure A-l. Schematic of Preassembly 
Macro Pass Operation 
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The macro library is a card deck in which the macros in the library are punched in a 
compressed form to minimize both library passing time and memory storage space. The 
macro library is read in first and is stored in memory. Then, the card deck of macro 
instructions is read in. This deck contains the parameters and controls required to 
generate a source code deck in Assembler format. The output deck represents the 
selected library routines modified as instructed. The source code deck may be combined 
with user source code cards and assembled as one element, or it may be assembled as 
a separate element and linked with other relocatable elements to make up a program. 

Because it is a card deck, the library is separable; only those routines called for during 
the operation of a particular Preassembly Macro Pass need be in the library for storage. 
The Preassembly Macro Pass ignores the presence of any blank cards in both the macro 
library and the macro instruction deck. 

A2. MACRO INSTRUCTION FORMAT 

A macro instruction is similar in form to a source code instruction; it has a label 
(optional), an operation code, and an operand consisting of one or more expressions 
separated by commas. The prime difference is that the macro instruction causes the 
generation of a series of source code instructions representing a number of Assembler 
operations; whereas a source code instruction causes the Assembler to do one specific 
operation. 

The format for a macro instruction is as follows: 



LABEL 


OPERATION 


OPERAND 


label 


operation 


P 1 ,P 2 ,P3 — ,Pn.N 1 =P n+1 ,N 2 =P n+2 ,N 3 =P n+ 3,..,N m =P n+m 



The label may be any symbol, but is not necessarily assigned the current value of 
the location counter. The operation is the name of the macro definition describing 
the pattern of the code to be included. The operand, P through P n + m , is a sequence 
of expressions specifying parameters. P^ through P n are called positional parameters. 
l?n + l through P n+m are called keyword parameters. A macro instruction may have 
positional parameters only, keyword parameters only, neither, or both positional and 
keyword parameters. 

A2.1. Parameters 

There are two types of parameters; positional and keyword. 

II Positional Parameters. All positional parameters must be specified before any 
keyword parameters may be specified. The order of the expressions in the operand 
determines the order of the parameters specified. Parameter specifications are 
separated by commas. When a positional parameter specification is omitted, the 
comma must be retained to indicate the omission. Thus, if a macro has three posi- 
tional parameters and the second one is not specified, the operand appears as 
follows: 



P l-P3 
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If the third parameter is not specified, and the second is specified, the operand is 
written: 

P l> p 2 
Thus, no trailing commas need be present. 

Keyword Parameters. The specification of a keyword parameter is as follows: 

N=P 

where: N is the name of the parameter (any symbol of four or fewer characters 
is a legitimate keyword name). 

P is the parameter specification (a value or a character string). 

Keyword parameter specifications are separated by commas; however, the comma 
need not be retained if the specification is omitted. There must be a comma between 
the last positional parameter and the first keyword parameter. The order of the 
keyword parameter specifications is not significant. For example, if a macro has 
three keyword parameters, the Operand of the macro instruction might be: 

N 1 =P 1 ,N 2 -P2,N3^P3 



N 2 =P 2 ,N 1 =P 1 ,N 3 =P3 
and so on. 

A macro may have positional and/or keyword parameters with commas separating 
the specifications. For example, the operand of a macro instruction with three 
positional and two keyword parameters might be as follows: 

p l' P 2< p 3' N l =p 4> N 2 =p 5 

The number of parameters which may be specified with one macro instruction depends 
on how much space is required to store the specifications. One macro instruction 
may normally specify as many as 50 parameters in its operand. When the operand 
overflows the space provided in one record, provision is made to continue" the operand 
in the following record by putting a nonblank in column 72. The continuation of the 
operand begins with column 16. The Macro Pass searches for a continuation record 
as soon as one of the two following events occurs: 

■ Information is taken from column 71 of the current record. 

■ A comma followed by a space is detected in the current record. 
Columns 1 through 15 of a continuation record must be blank. 
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If the information in a record is terminated prior to column 71 by means of a comma 
followed by a space, comments may be written after the space. For example, a macro 
instruction with three keyword parameters might be written as follows: 



LABEL 15 OPERATION* 
1 10 16 


OPERAND 




i i i i 1 i i 




Ml A,C,R,0 




N.l.-.P.ll., 


iC,OiMlMiE,NiT, 


1 1 


i i i i 1 i i 




1 , , i 






,C,0,M!M F E,N,T, 


I 1 


i i i i 1 i i 




_Xj_l__i_ 




... J__l 



72 80 


1 


X 


1 1 1 1 1 1 ! 


1 


X 


1 1 1 1 1 1 1 


J_ 




1 1 1 1 1 1 1 



The specification of a parameter may not contain an equal sign or a comma, except 
when it occurs between apostrophes. 

A3. WRITING MACRO DEFINITIONS 

The routines for the macro library are written in standard Assembler source code. They 
are then passed through a special run (the Compressor) to compress them into the 
library form expected by the macro pass. To distinguish one macro from another in the 
library, three directives are used: PROC, NAME, END. 

A3.1. PROC Directive 

The first source code statement of a macro definition is a PROC directive, which 
has the following form: 



LABEL 


OPERATION 


OPERAND 


(optional) 


PROC 


(optional) 



The label may be any symbol, but it is optional. When used, the label in the macro 
instruction calling on the macro is substituted for the PROC label, wherever the PROC 
label appears in the macro. For example, suppose the symbol MOVE were specified for 
the label of a macro instruction, that the label of the PROC directive of the associated 
macro was NAME, and that the macro contained the following line of source code: 



LABEL t OPERATION* OPERAND t 
1 10 16 


N.A.M.E, | , , 




M,5.a_ 




D , E , s , T . - 1°. R. ! . G , 1 i i i , , , i I , i i , l 













Then, the source code generated by the macro definition would appear as follows: 



1 1 1 1 1 1 1 




1 i i i 




i i i i 1 i i l i 1 i i i i I i i i ,i 1 i i I i 1 i i l i 1 


MiOiViEi 1 i i 




MlViCi . 




Di Ei Si Ti , 1 OiRil i Gi 1 i i i i I i i i i 1 i i i i 1 i i i i 1 
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If the PROC directive does not have a label, but the macro instruction does, the 
label of the macro instruction remains undefined. 

A3. 2. NAME Directive 

The second line of a macro definition must be a NAME directive, which has the form: 



LABEL 



label 



OPERATION 



NAME 



This is the call name for the macro and is the name that is specified in the operation 
field of the macro instruction. The name may have as many as five characters, the 
first of which must be alphabetic; the others alphanumeric. 

A3. 3. END Directive 

The end of a macro definition is indicated by an END directive. It has no operand 
and requires no label. 

If the following macro is in the library: 



LABEL t> OPERATION* OPERAND t 
1 10 16 


i i i i 1 i i 




P|R,0,C, 




1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


MiOiV.E, 1 i , 




N|A,M|E| 




1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 


i i i i 1 i i 




Ml V, C, , 




D, E,S,T| > | 0, R,l |G| | | , , , | , | , , | , , | , | , , , , 


i i i i 1 i i 




El Ni Di i 




i .i i i I i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 













then the macro instruction: 



J I 1 I I I L 



J I L_J L 



M L 0_ L V L E J 



J I I I I I I I I I I I I I I I I I L._L.1_J I -L-l 1-1 .1-1 I. 

I I I I 1 I I I I I I I I I L_J I I I 1 I I [..1.1 L L 1 i I. 



is equivalent to the source code instruction: 



! 1 1 1 1 1 1 




1 . . I 




1 1 1 1 1 1 1 1 ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 


1 1 1 1 1 1 1 




M|V,C, , 




D, E| S, T, , | 0, R, 1 | G, | | I, | | || I, | | i i i I ii ii 













Note that none of the macro directives (PROC, NAME, END) are produced as output 
of the macro pass. 



A3. 4. Comments 



Comment lines may be inserted between the last NAME directive and the END 
directive in a macro definition. Each of these comment cards must have an asterisk 
in column 1 and must end at or before column 67. (Columns 68—71 are used by the 
Preassembly Macro Pass for card sequencing.) 

Comments are not permitted on a PROC line if the PROC directive does not specify 
any parameters. However, they may be written after the last parameter specified in 
the operand and must be separated from the operand by at least one blank. 
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Comments may be written on Assembler source code lines, but they are not reproduced 
by the Macro Pass when the source code lines are generated. 

A4. INCORPORATING PARAMETERS INTO MACRO CODING 

The operand of a PROC directive, when used, has the following form: 

p,n,N 1 ,N 2 ,N 3 ,...,N m 

The first expression (p) in the operand is a symbol used to address the parameters 
for the macro. The second expression (n) is the number of positional parameters 
associated with the macro. The series (N^,...N m ) are the names of the keyword 
parameters. Any symbol of four or fewer characters is a legitimate keyword name. 
Listing the keyword parameters in this way makes them, in effect, positional parameters 
to the macro. For example, suppose the PROC directive has the following form: 



OPERATION 



PROC 



OPERAND 



p,3,Nl,N2,N3 



The macro has three positional parameters, PI, P2, and P3. It also has three keyword 
parameters, Nl, N2, and N3. Thus, the keyword parameters become, in effect, positional 
parameters P4, P5, and P6. 

The value specified for a parameter is substituted in the macro coding for an expression 
of the following form: 

P(n) 

where: p is the first expression in the PROC directive operand. 

n is the decimal number of the positional parameter. The first has a number 
of one, the second, two and so forth. 

For example, if the following macro is in the library: 



LABEL 15 OPERATION* OPERAND U 
1 10 16 


i i i i 1 i i 




PIR.O.C, 




P |f ,0 lfl D|E l S l T |f| L|G l T l H lf| 0|R l l l G l , | , , , , | , , , , | 


M.O.V.E, | , , 




N|A,M,E ( 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i 1 i i 




M|V,C, , 


p , (,!,),( |P,(,2,) ,)|m P ,(, 3 ,>I , , , , 1 , , , , 1 , , , , 1 


i i i i 1 i i 




E|N,D, , 




1 .1 1 1 1 1 1 1 1 1 1 ! 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 1 ! 1 













then the macro instruction 



l I I I 1 i : 




I i i I 




i i i i I i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1 1 I 1 1 1 1 




MIO.V.E, 




D, E,S, T, =| O, U, T 1# , l_| G,T,H,= , 1 1 6 , , , 0, R, 1 | Q = , 1 ,N, | , , , , | 













is equivalent to the source code instruction: 



9 i i i i 1 i i 




1 1 1 1 




i i i i I . i i i > i i i i l i i i i 1 i i i i 1 i i i i 1 


I 

* ! 1 ! 1 III 




MV L c J _ L _ 




0,U,T,( ,116,),,,! ,N| , , , , | , , , , | , , , , | , , , , | 
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A keyword parameter may also be addressed by writing its name preceded by an 
ampersand. Thus, the MVC instruction within the macro definition of the previous 
example could also have been written: 



LABEL 
1 


* OPERATION* OPERAND 
10 16 




* 


i i i i 1 i i 




M|V,C, , 




*lMilJjIAkl G llL H ±>l' 


l & i°L R l'i G l 1 J L 


J J .1 1 1 1 1 1 

















If a parameter value is unspecified, it will be replaced by the value zero. 

When the operand space overflows the space provided in one record, provision is 
made to continue the operand in the following record by putting a nonblank in column 
72. The continuation of the operand begins with column 16. The Macro Pass searches 
for a continuation record as soon as one of the two following events occur: 

■ Information is taken from column 71 of the current record. 

■ A comma followed by a space is detected in the current record. 

Columns 1 through 15 of a continuation record must be blank. If the information in 
a record is terminated prior to column 71 by means of a comma followed by a space, 
and if column 72 contains a nonblank, then all columns between the comma and 
column 72 must be blank. 



A5. NAME STATEMENT 

More than one NAME statement may follow the PROC statement of the macro. However, 
all the NAME statements in a macro must immediately follow the PROC statement. Each 
such NAME statement specifies a different name for the same macro. 

The object of giving a macro more than one name is to permit reference to different 
versions of the procedure embodied in the macro. The versions are distinguished 
within the macro by means of the operands of the NAME statements. 

Only one expression may appear in the operand of a NAME statement and may be 
assigned a value ranging from through 2l6_i. The expression may be a decimal 
number, a hexadecimal number, or a character expression of the form C'xx'. Any 
value greater than 2^— 1 will be truncated with no error indication given. This 
expression is essentially a parameter of the macro; it may be addressed in the 
macro as : 

P(O) 

where p is the first expression in the PROC statement operand; consequently, it may 
be used to distinguish between versions of a macro. 
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For example, if the following macro is in the library: 



LABEL * OPERATION* OPERAND * 
1 10 16 


l i i i 1 i i 




P|R,o.c, 


._ 


i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


MjV J 4 J _. J _J_ 1 _ 1 _ 
M,V f 8 , , | i i 




NIA.M.E, 


4| i i | | i i i i I i i i i I i i i i I i i i i I i i i i 1 


8| i i i 1 i i I i 1 I i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i 1 i i 




M|V,C, , 




D.E.S.T.t |P,( ,0,) ,) | f ,0,R, 1 ,G| i i i , I , i i i | , i i i I 


i i i i 1 i I 




EIN.D, , 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i I i i 




_L_I_L_L. 




i i i i 1 i i i i 1 i i i > 1 i i i i 1 i i i i 1 I i i i 1 



then the macro instruction 



. _L J . 


1 1 1 l 1 




_L_L._ 1 

M|V,4, 


__j 

i 


— 


_L J 


1 1 1 1 1 















___L_J_.i. .. i._J.._ i I L I J. I I I I L_i I I I I I 1 I I I I I I _L 

_i.-.l 1_1 ._! i._ 1 _L._l._I_J I L_l_l U I I L_J 1 I I 1 I I l__L 



would produce the source code 



1 1 1 1 1 1 1 




1 . . . 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1 1 1 1 1 1 1 




MlViC. i 




D, E, S, T, ( |4i) i. iOiRII id i i 1 i i i i 1 : i i i 1 i i i i 1 













while the macro instruction 



1 1 I t 1 1 1 




1 1 1 1 




! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 > 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


1 1 1 1 1 1 I 




M[V l 8 j __l 




i 1 1 1 1 1 I 1 1 1 1 1 1 1 1 I I 1 1 1 1 1 1 1 1 1 1 1 1 1 













would produce 



1 1 1 1 1 1 1 




1 1 1 1 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1 1 1 1 III 




M|V,C, , 




D,E,S,T,( | 8.) , , ,0,R| 1 , G, , , | , , , , | , , , , | , , , , | 













If a NAME statement has no operand, the parameter p(O) is assigned a value of zero. 

If a macro has no parameters and it makes no reference to the operand of any of its 
NAME statements, then its PROC statement has no operand. 
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A6. CONDITIONAL MACRO PASS INSTRUCTIONS 

The Macro Pass recognizes certain directives which can: 

■ exclude lines of coding from the output of the Macro Pass, 

■ include a set of lines in the output of the Macro Pass more than once 

■ establish and alter values which may be used to determine whether a set of lines 
shall be included or excluded. 

These directives are provided to control the pattern of coding generated, based on 
the parameters supplied in the macro instruction. 

A6.1. DO and ENDO Directives 

A DO directive controls the inclusion or exclusion of the lines following it, up 
to its associated ENDO directive. For example, in the following sequence of 
coding: 



LABEL t OPERATION* OPERAND t 
1 10 16 


l i i i 1 i i 




DlO, . i 




1 1 i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i til i i 




l.i. 




2| i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i 1 i. i 




D|0, , , 




3| i i i 1 i i i i 1 i i i i I i i i i I i i i i 1 i i i i 1 


i i i i 1 i i 




1 i i i 




4| i i i 1 i i i i 1 i i i i 1 I i i i 1 i i i i 1 i i i i 1 


i . i i 1 i j j 




1 . . i 




5| i i i 1 i i i i 1 i i i i 1 i i i ; i 1 i i i i 1 i i i i i 


i i i i 1 i i 




E|N,D,0, 




6| i i i 1 i i i | 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i I I i 




1 i , . 




7| i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i 1 i i 




1 i i i 




8| i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i 1 i i 




EIN.D.O, 




9| i i i I i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1,1 1 1 I 11 




1 1 I 1 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i .1 



the first ENDO directive is associated with the second DO directive, the second 
ENDO directive with the first DO directive. In other words, DO and ENDO directives 
are paired to produce nests. Thus, the first DO directive controls lines 2 through 
8, and the second DO directive controls lines 4 and 5. DO's may be nested to a 
depth of 10. 

The operand field of a DO statement contains a single expression. If the value of 
this expression is greater than zero, it represents the number of times the lines 
controlled by the DO statement will be included in the output. Otherwise, these 
lines will not appear. For example, if the following macro is in the library: 
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LABEL t OPERATIONS OPERAND t 
1 10 16 


i i i i 1 i i 




PIR.O.C, 




P,,,0,, ,A|C,T, , , [ , , , , | , , , , | , , , , | , , , , | 


M i°i V i E i 1 . i 




N| A,M,E, 




. . i . 1 . , . . 1 , i . . 1 . i i , 1 i , , , 1 . , i ■ 1 


i i i i 1 . i 




DlO, , , 




P|<,1.), 1 , , , , 1 , , . , 1 , , , , 1 , , i , 1 , , , , 1 


,,>.(,, 




MIY.C, , 




D 1 E 1 S 1 T lf |0 1 R,l l G, | , , , , | , , , , ! , , , , | , , , , , 


. i . > 1 . i 




EIN.D.O, 




i i , i 1 i i , i 1 , , , , 1 , i . , 1 , , i , 1 , , , , 1 


•' < i i 1 i i 




E|N,D, , 




. , , ■ 1 i , , , 1 , , . , 1 , . , , 1 i , i , 1 , , , , 1 













then the macro instruction 



1 1 1 1 1 1 1 




1 , , , 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1 1 1 1 1 1 1 




MlO.V.Ei 




AiCiTi =i 1 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1 1 1 1 1 1 1 




till 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 



would produce the instruction 



1 1 1 1 1 1 1 




1 I , 1 




i i i i I i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


1 1 1 1 1 1 1 




M|V,Ct , 




D|E,S,T|,, |0|R,l , G| | i i i i | | | | | | | | | | | | | | | | 













in the output of the macro pass; whereas, the macro instruction 



.J L_J I I I L 



J I I I I I I I I I I I I I L L 



i I i [ l I I l l I I 



-L I I I I I 



MlOiVIE, 



A|C,T, = ,0 



_l_i_J L_L 



J_J L_L 



would not produce the instruction. 
Note that the macro instruction 



1 1 1 1 1 1 1 




1 1 1 I 




I . I I i 1 i i i i 1 i i i i 1 i i i i 1 i t i i 1 i i i t 1 


1 1 1 1 III 




MIO.V.E, 




i i i i I i i l l I i i i i 1 i i i l 1 i i i i 1 i i i i 1 













would also cause the suppression of the instruction. 

A DO statement may have a symbol in the label field. This symbol may be used only 
in the statements controlled by the DO. Its value is one the first time these state- 
ments are generated, two the second time they are generated, and so on. If the DO 
is under the control of another DO, and is activated again, the count begins at one 
again. Only two DO directives within a nest of DO's may be labeled. 
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P f GE: 



A6.2. GOTO and LABEL Directives 

The form of the LABEL statement is 



LABEL 


OPERATION 


OPERAND 


symbol 


LABEL 


not used 



The symbol in the label field of the LABEL statement is not defined in the usual 
sense. It may be used only in the operand field of a GOTO statement. 

The GOTO directive is used to direct the Macro Pass to another point in the macro 
definition in its production of source code. 

The form of the GOTO statement is 



LABEL 


OPERATION 


OPERAND 


not used 


GOTO 


symbol 



The symbol in the operand field must be the label of a LABEL statement. 
If the following macro definition is available: 



LABEL * OPERATION* 
1 10 16 


OPERAND 




* 




i i i I I, l i ... 




PLRiOlCl. 




P,,,0,, ,F|0, U 


"i I I i i i i 1 


_L±. 1 1- L t J.. l_l i L 


.^LlJ 


M.OiV^, | , , 


- 


NiA.iM.E, 
D|0, , , 




P.(|l|) , i , , 


1 _l_l_l_J_l L_l 


1 1 1 1 1 1 1 1 


L 1 1 

1 1 


_I_. L 1 J 




1 I 1 1 , 1 1 1 


1 1 1 1 1 li 1. 1 


J_ L.._L. 1 






M|V,C, , 




D| E, S, T,( 14,) , 


. ,0|R|l iG, , , 1 


1 1 1 1 1 1 i 1 


1 1 


_J_J_L 1 






GIOiTOi 




Ei N, D, i 1 i , , i 1 , , , , 1 


1 1 1 1 1 1 1 1 


1 1 


. . ! 1 






E|N,D ( , 






1 1 1 1 1 1. I 1 


1 1 


1 1 1 1 






MIViC, , 




P E, S, T,( |8,) , 


. .O.RI 1.0, i , I 


I . 1 1 1 i. 1...I 


! i 


^1_L^J 


E,N|D, i | , i 




M A |B,E,L 




i i i i 1 i i i i 1 i i i i 1 


1 1 1 1 1 1 1 1 


1 i 


,,,l 


i i i i 1 i i 




E|N,D, i 




III 1 1 1 1 1 1 1 1 1 ! 1 1 


1 1 1 1 I 1 1 1 


1 i 


> 1 I i 





















then the macro instruction 



I l l l I I L 



J 1., 1 



M | Q , V , E, 



-1—1 — I 1 1 i I I L 



F .o.u. *.=|i, ■ ■ ■ 



would produce the instruction 



J L 



I I I I I 



I i I I 1 1 I I L. 



I I I I 1 l . I i 



J I— I — L 



l I I I I l_. J L _L_L 

i i i i 1 i i u. -i L 



i ' 1 LJL_J I L_l L_l — L 



-i— I I I I I L 



M i V ! C | ■ 



D , E ? J S \ 4 .K. PW i c ,_ ,^J^^^L^ 



J 1 L 
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while the macro instruction 



LABEL 



* OPERATION* 
10 16 



OPERAND 



i_ J i- J. L__ 1 i 



M l i V i E l 11.1.1 l__l l_J.._L_l__L_ 



would produce the instruction 



J I L_l I I L„l L_L_1 L_J L_l 1 L_JL. 



i I L._L_J I L 



I I L L 



Mi^L?L 



. __1_JL_L__1_1_L. J L_J_J_ 



_L_L_JL 



Pi 3i SJQ j jSjJ.i^QiR Jx.Gl .!_..!„ 1 1 __1.._±_.L_1.. 



1_JL_1_ 



For any GOTO statement, the corresponding LABEL statement must appear in the 
same macro definition as does the GOTO statement. If a GOTO is within the range 
of statements under control of a DO statement, but the addressed LABEL statement 
is not, then execution of the GOTO will terminate the DO whether the DO count, 
as expressed in the operand field of the DO statement, is exhausted or not. 

A6.3, Set Variables 

A set variable is a symbol to which a value is assigned during the generation of the 
code corresponding to macro instructions. Unlike an ordinary symbol, the value 
assigned to a set variable may be altered during the course of the Macro Pass. A 
set variable may be either a local or a global variable. A global variable, once 
declared and given a value by a SET statement, remains defined throughout the 
Macro Pass and retains the same value until that value is changed by another SET 
statement for that variable. A local variable is defined only within the macro def- 
inition within which it is declared. A value assigned to a local variable within one 
macro definition does not affect its value within any other macro definition in which 
a local variable with the same name is declared. 

Before a set variable may be set, it must first be declared by a GBL or a LCL 
directive. The symbol naming a set variable must consist of four characters. 

A6.3.1. GBL Directive 

The GBL statement has the form 



LABEL 


OPERATION 


OPERAND 


not used 


GBL 


&G%xx 



where: 00<xx<49 



The symbol in the operand field of the GBL statement is declared to be the name 
of a global set variable. The symbol must consist of four characters, not counting 
the ampersand, and take the form shown above. 
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A6.3.2. LCL Directive 

The LCL statement has the form 



LABEL 


OPERATION 


OPERAND 


not used 


LCL 


&L%xx 



The symbol in the operand field of the LCL statement is declared to be the name 
of a local set variable. The symbol must consist of four characters, not counting 
the ampersand, and take the form shown above. 



A6,3.3. SET Directive 



The SET directive is used to assign a value to a set variable. The form of the 
SET statement is 



LABEL 


OPERATION 


OPERAND 


symbol 


SET 


expression 



The symbol in the label field is the name of the global or local set variable to 
which a value is being assigned; the expression in the operand is the value to 
which the set variable is to be set. The value of the expression may range from 
through 216— 1. Until a GBL or LCL variable is set by a SET directive, it has 
the value zero. Once it has been set to a specific value by a SET directive, the 
set variable retains that value until it loses its declaration, or until it is set to 
another value by another SET directive. Declaring a set variable does not affect 
its value. 

A set variable may be addressed by writing its name preceded by an ampersand. 

A6.3.4. Relational and Logical Operators 

Expressions in the operands field of machine instructions and most Assembler 
directives contain only the arithmetic operators, add and subtract. The expression 
in the operand field of a SET or DO statement may contain these arithmetic 
operators; and in combination with these, it may also contain the following: 

■ Arithmetic Operators 

— multiply (*) 

■ Relational Operators 

— greater than (>) 

— equal (=) 

— less than (<) 
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■ Logical Operators 

— logical-and (**) 

— logical-or (++) 

The relational operators compare two unsigned binary numbers. The value of a 
relational expression is 1 if the relation is satisfied; otherwise, it is 0. Thus, if 
CHAN is the name of a keyword parameter, the expression 

&CHAN = 5 

would have the value 1 if 5 had been specified as a value of the parameter CHAN; 
otherwise, it would have the value 0. 

The logical operators treat a value as a string of 16 bits and produce a 16-bit 
value. The "logical and " operator corresponds to the NC instruction and the 
"logical or" corresponds to the OC instruction. 

The precedence relation of the various operators in decreasing order is as follows: 

1. * 

2. + - 

3 ** 

4. ++ 

5. > = < 

Parentheses may be used to override this precedence relation. 

A6.3.5. Character Values 

A character value is a string of up to 13 characters enclosed in single apostrophes. 
Apostrophes within the character string must appear as pairs of successive apostro- 
phes. Ampersands within the character string must appear as paris of successive 
ampersands. 

A6.3.6. Use of Character Values 

A character value may appear as an operand of a relational operator. The following 
rules apply: 

■ A numeric value is greater than a character value. 

■ A character value is greater than any shorter character value. 

A series of characters enclosed by separators is considered a character value. 
The following are separators: 

( * 

) 15 = 
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Such a character value may have a maximum length of 15 (including leading and 
ending apostrophes when they occur). 

A character string in the macro definition which: 

1. Matches a set variable name except for the absence of the leading ampersand, 
and 

2. Is not enclosed in apostrophes, 

will be accepted as the name of that set variable. This type of character string 
must be enclosed in apostrophes to be treated as a character value. 

If the operand field of a SET or DO statement contains an expression which could 
not otherwise be evaluated, that expression will be treated as a character value 
even though it is not enclosed in apostrophes. 

The following is an example of the use of a local set variable. If the following 
macro is in the library: 



LABEL t OPERATION* OPERAND t 
1 10 16 


i i i i 1 i i 




pIriO'Ci 




P.. iO. . 1AIC1T1 i i 1 i i i . 1 i i i i 1 i i i i 1 i , i i 1 


M1O1V1E1 1 i i 




NIA.M, Ei 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


i i i i 1 i i 




LICiL, , 




&|L,7q0,0| | | | | | i | | , | , | , , | , | , | | i , , , | 


8hLi%i0i0I > i 




SI E,Ti i 




Pi ( il i ) i = l* iY.E.S,' | , , , , | , , , , | , , , , | , , , , | 


..::\ , J, ,L .... 1 j „i ,1 , 




D|0, , , 




&,L,%,0 ( 0| , , , , | . . , , 1 , , < , 1 i , , , 1 , , ., , 1 


1 1 1 1 1 1 1 




M|V,C, , 




D.E.S.T,, iO.R.I ,G, | , , , , | , , , , 1 , , , , 1 , , , , 1 


1 [ ! 1 1 1 1 




E|N,D,0, 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i i 


! 1 1 1 1 1 1 




E|N,D, , 




i i i i 1 i i i i 1 i i . i i 1 i i i i 1 i i i i .1 i i i i 1 













then the macro instruction 



I 1 1 1 1 1 1 




1 . . . 




i i i i 1 i i i i 1 l i i i 1 i i i i 1 i i i i 1 i : i I 1 


1 1 1 1 1 1 1 




M|0,V,E, 




A, C,T|= i Y |E j S i i i I i i i i | i i i i 1 i. i i . i 1 i i i l. 1 













would produce the source code instruction 



1 1 1 1 III 




1 . . . 




i i i i 


1 i i i i 1 i i i 


i 1 i i i i 1 i i i i 


1 i i i i 1 


1 1 1 1 1 1 1 




M,V,C, , 




D E S T , 

i i i i 


iORI G | 

I i i i i I i i i 


i 1 i i i i 1 i i. i i 


1 i i i i 1 



















while any other form of the MOVE macro instruction would suppress production 
of the source code instruction. 
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The following is an example of the use of a global set variable. Assume the 
following two macros are in the library: 



LABEL t OPERATION* OPERAND 6 
1 10 16 


_J_J _l__L._L_j_JL 




PIRiOiCi 




Pi. i Oi , 1AIC1T1 i.i 1 i i i i 1 1 i i i 1 i i i i 1 i i i i 1 


G l', V l E l 1 1 1 




NjA,M, E, 




iiiiliiiiliiiiliiiiliiiiliii.il 






G|B ( L, , 


&,G I %,0,0| , , , , | , , , , | . . i , 1 i . i i 1 , , i > 1 


& I G I % |°I°I 1 1 




S|E,T, , 




■V.Mrl'.Y.E.S/ I , , , , I , , , , I , ■ , 1 






D|O t , , 




&. G.%,0,01 1 . . . < 1 , , , i 1 . , i , 1 






MIV,Ci . 




DiEiS.Ti. IOi Rl iG. 1 i . i i 1 i . . . 1 . . . . 1 i i i . 1 


. . . . 1 . . 




E|N,D, 0, 




i i i i 1 i i. i i 1 i i i i 1 i i i i 1 i i i i 1 i . i i i 1 






E|N ,D, , 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 






P|R,0,C, 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 


T | A | K | E i 1 1 1 




N|A,M, E, 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 > i i i 1. i i i i 1 






D|0, , , 




&, G.M.0I i i i i 1 i i i i 1 i i . i 1 i . i i i 1 . i , i 1 






M|V,C, , 




qR,l,G |f |D l E l S 1 T 1 1 , , , i 1 , , , , 1 , , , . 1 , , , , 1 






E|N,D, 0, 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 






E|N,D, 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i i 1 













If the only macro instructions in the source statements for a particular assembly 
are the following: 



1 1 1 1 1 1 1 




1 I , 1 




i i i i 1 i i i i 1 i i i i 1 i i i i .1 i i i .i 1 i i i i 1 


1 1 1 1 1 1 1 




G|I,V, E, 




AjCi Ti = |Y|E| Si . i . i | i i i i | i i i i | .i . i i . i 1 i i | i | 


1111 111 




T|A,K, E, 




i i i i 1 i i. i i 1 i i i i 1 i i i i 1 i i i . i 1 i i . i i 1 













in the order shown, then the following source code would be produced: 



1 1 1 1 III 




1 I 1 I 




i i i i 1 i i i i 1 i i i i 1 i i i i 1 i i i. i 1 i i i i 1 


1 1 1 1 111, 




MIV.C. , 




DiEiS |T i, 1 Oi Ri 1 i Gi 1 i i i i 1 i i i i 1 i i i i 1 i.i. i i 1 


1 1 1 1 1 1 1 




MlV.C. , 




OiRil iG i, 1 Di Ei SiTi i i i i i 1 i i i i 1 i i i i 1 i i i i 1 













If the only macro instructions in the source statements for a particular assembly 
are the following: 



_i j l i , . I L_L 



X-l I 1 1 



J L 



J J L_J I I L 



J I L 



G | I | V | E | 
Tl A, K, E, 



J I I L. 



J. I -I L 



_1_J I I I I L_l I I L_l I I I . I .1 I L_l I L 

''ill L_l l_J LJ L_J L_l I I I I I „ 1,1 



J I I L J I I 1 l_J 1 i „ 1 J I J 1 L 



1 I I L , 1 . ,1 I I L 
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no source code would be produced. 

If the only macro instructions in the source statements are the following: 



LABEL t OPERATION* OPERAND U 
1 10 16 


i i i i 1 i i 




TlAiKiEi 




! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


i i i i 1 i i 




Gllo.VL.Ei_ 




A, C, Tj = , Y | E, S , , | | , , i i | | | | | | | | | i | i , , , | 













then the following source code would be produced. 



1 I I 



J L 



.J I ' ' 



J 1 I L 



MIV.C, 



D. E.S.T,, lOiR.I ,0 



i I I 1 I L 



Thus, the value of a global set variable is a function of the order of the macro 
instructions in the source statements. 

A7. CONTINUATION CARDS 

Continuation cards are allowed on all cards in a macro definition except comment 
cards. 

The following rules will cause a continuation mark to be searched for: 

■ A comma followed by a space is detected. 

■ A comma in column 71 is detected. 

■ A separator in column 71 is detected (except on a PROC directive card). 

Columns 1 through 15 of a continuation card must be blank. Column 16 of a continuation 
card must contain the next valid character of the operand. 

A8. LABELS USED IN UNIVAC PRODUCED MACROS 

It should be noted that if the output of a macro pass is to be combined with user source 
code cards and assembled as one element, any symbol used as a label in a source 
code instruction produced by the macro pass may not be used as a label in the user's 
own code. To avoid the necessity of the user checking a list of symbols used in 
Univac written macros, a special feature has been incorporated into the Assembler to 
allow all such symbols to incorporate a question mark as their second character. 

A9. MACRO INSTRUCTION DECK 

Regardless of the order of the macro routines in the library, the macro instruction 
deck may be in random order with respect to the library, and a particular macro may 
be referenced as many times as desired. However, the order of the macro instructions 
does determine the sequence of the source code instructions generated as output of 
the macro pass operation. 
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During the macro pass operation, any cards in the macro instruction deck that are not 
macro instructions referring to macros in the macro library are reproduced unchanged in 
the output source deck. 

The macro pass operation recognizes the end of the macro instruction deck by means 
of an END card which it reproduces and includes at the end of the output source code 
deck. 

A10. MACRO PASS OUTPUT FORMAT 

The Preassembly Macro Pass can produce four types of output cards. The formats 
for these cards are presented in the following paragraphs. 

A10.1. Source Code Card Format 



Columns 


Contents 


1-4 


Label 


5 


Blank 


6-10 


Operation 


11 


Blank 


12-67 


Operand Field (No Comments) 


69-71 


Card number within the macro 


72-73 


Blank 


74 


Asterisk 


75-76 


Blank 


77-80 


Columns 77—80 of last parameter card 



A10.2. Macro Instruction Card Format 



Columns 


Contents 


1 

2-72 

73-80 


Asterisk 

Columns 1—71 of the input card 

Columns 73-80 of the input card 



A10.3. Comments Card Format 



Columns 


Contents 


1 

2 

3-68 

69-80 


Asterisk 

Blank 

Comment 

Same as standard source code format 
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A maximum of 65 characters of the original comment line will be preserved and all 
leading and terminal blanks will be dropped. 

A10.4. Error Card Format 

There are certain rules of writing macro definitions which may have been broken. 

If they have been broken, a card will be punched containing the following information: 



Columns 


Contents 


1 

2-4 

5 

6 

7-68 

69-80 


* 

Blank 
E 
Error Code (see below) 
Blank 
Same as standard source code format 



The error codes are: 



CODE 



MEANING 



Too many right or left parentheses occur in a DO or SET directive. 

The first character of a DO or SET directive is a separator other than 
a minus sign, a left parenthesis, or an apostrophe. 

The information to be turned out as one source code statement will 
not fit on one card. 



All. MACRO PASS CONSOLE DISPLAYS 



Display 


Reason for Stop 


Action 


01FF 


Macro Library is loaded. 


Press the START switch to process 
the macro instruction deck. 


1FFF 


Current macro instruction 


Press the START switch to process 




deck has been processed 


another set of macro instructions. 




(END card has been read). 




0111 


Card count check failure 


Remove all cards, beginning with the 




while loading the Macro 


error card, from the read unit. 




Library. After the card 






read device has been 


Determine reason for error (shuffled 




cleared, the card in error 


cards, etc.) and place corrected deck 




will be the third card from 


in the input stacker. Feed one card, 




the last in the output stacker. 


press the START switch. The next 
card to be read will be examined to see 
if it is in correct sequence. If it is, 
normal processing w ill continue. If it 
is not, it will be assumed that a new 
macro is being loaded. The card count 
expected will be card number 1 and the 
previous macro will be ignored. 
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Display 


Reason for Stop 


Action 


0122 


Hole count check failure 


Remove all cards, beginning with the 




while loading the Macro 


error card, from the read unit. Replace 




Library. After the card 


in read unit, feed one card and depress 




read device has been 


the START switch. If the same stop 




cleared, the card in error 


occurs again, the card has been in- 




will be the third card from 


correctly punched. Restart with different 




the last in the output stacker. 


library. 


0177 


Not a library card. Column 


Remove error card. Place all cards 




1 does not contain a 


following error card back in input 




12—3—9 punch and the card 


hopper. Feed one card. Depress START 




is not a blank card. After 


switch to continue normal processing 




the card read device has 


of the Macro Library. 




been cleared, the card in 






error will be the third card 






from the last in the output 






stacker. 




0100 


An end sentinel card has 


Remove all cards, beginning with the 




been detected (/*) but the 


end sentinel card, from the reader. Find 




card preceding is not a 


the 'Z' card and place in reader followed 




'Z' type card. After the 


by rest of library deck. Feed one card and 




card read device has been 


and depress START switch. If the card now 




cleared, the end sentinel 


read is a 'Z' card, normal processing will 




card will be the third card 


be resumed. If it is not a 'Z' card, the 




from the last in the output 


current macro will be destroyed and it 




stacker. 


will be assumed that a new macro is 
being processed. 


0133 


Current library will not 


Remove rest of current macro (up to first 




fit in computer memory. 


'Z' card) deck. Place rest of library back 
in reader and depress the START switch. 
Processing will resume with processing 
of a new macro which will overlay start 
of the previous one. 

Another choice is to break down the Macro 
Library deck into smaller libraries and 
reload. 
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A12. LINKING THE MACRO PASS 

The Macro Pass is composed of several separately assembled parts which must be 
combined with a Linker run in order to produce a loadable Macro Pass. The following 
description of how to link the Macro Pass assumes a two-pass Linker operation. The 
Macro Pass can operate in an 8K UNIVAC 9200/9300 system. 

The Macro Pass is a single-phase program. The PHASE control card to be used in 
linking the Macro Pass is as follows. 



LABEL 
1 


* OPERATION t> 
10 16 


OPERAND 




t 


i i i i 1 i i 




PIH.A.S.E 




M, A, C, , 


1|2,8,, ,A, | 


i i i _i_J_ l j._ 


1 L L_ 1 1 1 1 1 

















EQU cards for the linking operation should follow the PHASE card. Following the 
EQU cards should be the relocatable object code decks of the elements making up 
the Macro Pass. 

The first element of the input deck must be the Card Load Routine. If the online 
card reader is going to be used to load the Macro Pass, the name of the Card Load 
Routine is LD. If the Card Controller is going to be used, the name of the Card 
Load Routine is LDCC. 

The last element of the input deck must be the Macro Pass element named MP. 
The following elements may appear in any order between the Card Load Routine 
and the MP elements. 



A card read routine. This could be either the Systems Programming internal routine 
for the online serial card reader, named XRDR, or the Systems Programming internal 
routine for the Card Controller named XRDC. If XRDC is used, then an EQU card 
of the form 



LABEL 


OPERATION 


OPERAND 


RDCN 


EQU 


n 



should be included with the other EQU cards in the input deck, 
of the channel on which the Card Controller is located. 



: n' is the number 



An input translation table. To allow the user to punch source code in any card 
code that he wishes, the Macro Pass uses a user-supplied translation table to 
translate from card to internal code. The Macro Pass assumes that the result 
of the translation is EBCDIC. The input translation table must be labeled RDTT. 
If source code cards are punched in Hollerith, then the UNIVAC supplied Hollerith- 
to-EBCDIC translation table, which is named TBRD, can be used. In this case 
the following card should be included with the other EQU cards in the input deck: 



LABEL 



RlPlIlTl 



15 OPERATION* 
10 16 



E [ Q|U| I 



0|,|T|B,R|D, 



OPERAND 



I I I I 1 I M i l l 



1 I 1 1 .1.1 



_LJ_J__l 
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A card punch routine. This is either the UNIVAC supplied internal routine for 
the online serial punch, named XPCH, or the UNIVAC supplied internal routine 
for the row punch, named XPRW. If XPRW is used, then an EQU of the form 



LABEL 


OPERATION 


OPERAND 


CHAN 


EQU 


n 



should be included with the other EQU cards in the input deck, 'n' is the number 
of the channel on which the row punch is located. 

An output translation table. To allow the user to have the output source code of 
the Macro Pass punched in any card code that he wishes, the Macro Pass uses a 
user-supplied translation table to translate from internal code to card code. The 
Macro Pass expects all information to be translated from EBCDIC. The output 
translation table must be labeled PHTT. If it is desired to have the cards punched 
in Hollerith, then the UNIVAC supplied EBCDIC-to-Hollerith translation table, 
named TBPU, can be used. In this case, the following card should be included with 
the other EQU cards in the input deck: 



LABEL 
1 


* OPERATION* 
10 16 


OPERAND 


* 




JliHiT.Jj_.l_i_! 




§1QjU__j__ 




A i j_T_B_ i Pj_ 1 . 


i i i 1 i i > i 1 ii 


i 1 i i i i 1 i i 


1 I 1 











Blank card separators may be placed between the elements in the input deck, as the 
Linker ignores blank cards. 

The END control card used when the Macro Pass is linked must have the operand 
field: 



0,INIT 



A12.1. Operating Instructions 



1. Place the Macro Pass deck, the optional CTL card, the compressed library 
deck including the final /* card, and one blank card in the reader. 

2. Load cards. 

3. Stop X'OIFF' 

4. Place macro instructions including the END card in the reader followed by 
two blank cards. 

5. Press the START switch. 

6. Stop X'IFFF'. Final stop. 

7. The punch output hopper contains the source code cards for assembly. 

8. To process another set of macro instructions return to Step 4- 

To process a second library, the Macro Pass must be reloaded, since in processing 
macro instructions, the Macro Pass overlays the routine used to load the library. 
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A12.2. Control Card 

The compressed library deck may be preceded by a control card, which contains 
CTL in columns 10, 11, and 12, and a decimal number beginning in column 16. The 
number may take any value between 8191 and 32767. If a control card is present, 
the decimal number tells the Macro Pass the memory size in which it is to operate. 
If the control card is absent, or if the value specified lies outside the permissible 
range, the Macro Pass assumes that it is to operate in a 16K memory. 

A13. THE COMPRESSOR 

The purpose of the Compressor is to process source coded macro definitions and from 
these create a binary compressed macro library, which may then be used by the Macro 
Pass to create a source code deck from macro instructions and the Macro Library. 

The Compressor run creates a macro library from macro definitions which may then 
be used as input to the Macro Pass. One or many macro definitions may be passed 
through the Compressor at a time. 

Each macro definition is terminated by an END card and each library of macro 
definitions is terminated by an end sentinel card (/* in columns 1 and 2 of the 
input card). 

The Compressor run takes all macro definitions, up to an end sentinel card, and 
produces both a printed listing and an EBCDIC, binary punched card deck. 

The printer output consists of a listing of all input cards, plus an error code wherever 
the macro definition is incorrect. At the end of each macro definition, a total macro 
error count is printed and the paper is advanced to a new page. 

The card output consists of one or more macro definitions punched in compressed 
binary format. Each binary card is numbered consecutively within the current macro 
definition. Each macro within the library causes several binary cards to be punched. 
These cards begin with a count of one, and contain an identification which is taken 
from columns 73—77 of the PROC directive of the macro definition. The output macro 
library is followed by an end sentinel card. 

A13.1, Compressed Macro Library Deck Format 

All cards in the macro library produced by the Compressor have the following format: 



Col umns 


Contents 


1 
2 
3 

4-72 

73-77 

. 78-80 


12—3—9 punch 

Checksum of columns 3—72 in binary 

Card type ID; B, C, or Z 

Variable information in binary 

Identification 

Card number in Hollerith (starts with 1 for each macro) 



The card number is stored in the numeric portions of columns 78—80. These 
columns may be overpunched. 

End of library is /* in columns 1—2. 
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A13.1.1. Data Cards 



These cards contain the actual representation of the macro in the order it appears 
in the internal format. In this internal format, each macro definition is preceded by 
an eight-byte header, containing information used by the Macro Pass to process the 
macro definition when it is called. When the macro definition is processed by the 
Compressor, it leaves the first six bytes of this header filled with zeros. In the 
last card of the macro definition, it supplies the information that the Macro Pass is 
to insert in these six bytes before processing the macro definition. 

The information on a data card is as follows: 



Columns 


Contents 


3 

4 

5-n 


B Identifies data card. 

A number which is one less than the number of 
characters of macro definition on this card. 

The actual characters of macro definition. 

This information may extend as far as column 72. 



A13.1.2. Fixups 



Since GOTO references to a label of a LABEL directive may be forward references, 
all such references to a single label are chained. The operand field of a GOTO 
receives the address of the last previous reference ( relative to the address of the 
first character of the header of this macro) . The information for fixing these refer- 
ences is contained on special cards after the end of the body of the macro. The 
format of these special cards is: 



Columns 


Contents 


3 

4 

5-7 2 


C Identifies a fixup card. 

The number of items of fixup information on 
this card. 

A variable number of items of fixup information. 
Each item consists of four bytes of information. 

0,1: relative value of the label. 

2,3: relative address of last reference to the 
label. 



Note: Fixups also occur for other types of information. Some of these may occur 
in the punched output interspersed with the data cards. 
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A13.1.3. Header Specification 

This is the last card of the representation of a macro. It contains the information 
required for fixing up the header. 



Columns 


Contents 


3 

4 
5,6 

7,8 
9,10 


Z Identifies this card as a header specification. 

blank 

The total number of bytes occupied by the macro 
in internal format. 

The relative position of the start of the Name 
table within the macro. 

The relative position of the start of coding 
within the macro. 



The last card of input to the Compressor must contain /* in columns 1 and 2. 
The last card of output from the Compressor is such a card. 

Several macro libraries may be created from one library by inserting an end 
sentinel card after any or all 'Z' cards. 

One macro library may be created from several by removing all end sentinel 
cards from each library and combining these decks, followed by an end 
sentinel card. 



A13.2. Error Indications 

When the Compressor detects an error in the source code of a macro definition, 
it flags the erroneous line of source code with a one-character flag. One or more 
of these flags may occur on a line. The flag is an indication of the error type. 
Flags and their meaning are as follows: 

(X) One of the following has been detected: 

— A label of a line other than a macro language directive consists of more than 
four characters. 

— An operation consists of more than five characters. 

(B) One of the following rules was broken on the operand field of a DO or SET Line: 

— A right parenthesis must be followed by a space, a right parenthesis, or an 
operator. It must be preceded by a term or a left parenthesis. 

— A comma may not appear. 

— A left parenthesis must be preceded by an operator, a left parenthesis, or a 
space. It must be followed by a term, a minus sign, or a left parenthesis. 
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(£) A character string is greater than 15 characters, including leading and ending 
apostrophes. 

(6) A label which has been defined by a LABEL directive occurs as a label of 
another line. 

(E) One of the following has been detected: 

— In parameter references of the type P(n), a right parenthesis is missing, or it 
is not followed by a space. 

— In parameter references of the type P(n), an illegal separator occurs after 
the left parenthesis. 

— The operand of a NAME directive specifies a value of more than 2 iD — 1. 

— On C. . . ' type constants, the terminal apostrophe is not followed by a 
separator. 

— The explicit length specified in a DC or DS directive is less than one. 

— A hexadecimal constant is greater than 16 bytes. 

— A location counter reference (*) is not followed by a +, — , space, or comma. 

(F) More than ten DO's are nested together. 

(G) A comma is followed by a separator in the operand field of a PROC directive. 
(T) One of the following has been detected: 

— Part, or all of the line has not been processed due to the occurrence of 
one of the other errors. The other error code will be printed with the I. 

— An ENDO occurs without a corresponding preceding DO. The line is ignored. 

— The line is not under the control of a PROC directive and will be ignored. 

(K) The keyword which is referenced within the macro is not defined in the PROC 
directive. 

(L) More than two DO labels occur within nested DO's. 

(§) An ENDO is missing. Each DO must match with an ENDO. 

(R) The number of positional parameters defined in the PROC directive is nonnumeric. 

@ One of the following has been detected: 

— There is no operation field on this line. 

— A NAME directive does not follow a PROC directive or another NAME directive. 

(P) The macro is incomplete. An END record does not occur before the next PROC 
directive or before the end sentinel card. 
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(T) One of the following has been detected: 

— A GOTO directive label consists of more than 4 characters. 

— A keyword defined by the PROC directive is more than 4 characters long. 

— The name defined on the PROC directive for referencing positional parameters 
is more than 4 characters long. 

(0) A GOTO references an undefined label (LABEL directive is missing). 

(X) Some restriction which the Compressor places on the continuation of information 
from one card to the next has been violated. The restrictions are as follows: 

— If an input card has a continuation mark in column 72, the last character from 
this card must be a separator. 

— If a PROC directive card has a continuation mark in column 72, the last 
character from this card must be a comma. 

A13.3. Compressor Console Displays 



DISPLAY 


REASON FOR STOP 


ACTION 


1111 


A GOTO or LABEL directive 
is being processed and the 
label table is full. 


The Compressor does not have 
enough memory space to continue 
processing this macro definition. 
If the user desires the Compressor 
to begin the processing of another 
macro definition, he should remove 
any remaining cards of the current 
macro definition from the card read 
unit, load the next macro definition 
into the card read unit and depress 
the START switch. The Compressor 
will terminate processing of the 
current macro definition and start 
processing the next macro definition. 


1FFF 


The Compressor has either 
just been loaded or has 
completed processing a 
Macro Library. 


Depress the START switch to have 
the Compressor process the next 
Macro Library. 
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A13.4. Linking the Compressor 

The Compressor is composed of several separately assembled parts which must 
be combined by a Linker run in order to produce a loadable Compressor. The following 
description of how to link the Compressor assumes a two-pass Linker operation. 
The Compressor can operate in an 8K UNIVAC 9200/9300 System. 

The Compressor is a single-phase program. The PHASE control card to be used in 
linking the Compressor is as follows: 



LABEL 



t! OPERATION t> 
10 16 



OPERAND 



PJlHiAlSjE 



C l M L P u .i2l6 1 ii _ l A J 



_i_j i i L 



EQU cards for the linking operation should follow the PHASE card. These EQU 
cards define the following labels as indicated: 

— BLNK — 64 if a 63 /character print bar is to be used when running the Compressor; 

otherwise, 16. 

— FONT — Zero if a 63 /character print bar is to be used; otherwise, 128. 

— PRTR — Fifteen if a 63/character print bar is to be used; otherwise, zero. 

— PRTT — Zero if a 63/character print bar is to be used; otherwise, 0,TBPR. 

The EQU cards should be followed by the relocatable object code decks of the 
elements making up the Compressor. The first element of the input deck must be 
the Card Load Routine. If the online card reader is going to be used to load the 
Compressor, the name of the Card Load Routine is LD. If the Card Controller is 
going to be used, the name of the Card Load Routine is LDCC. 

The last element of the input deck must be the Compressor element, named CP. 
In between the Card Load Routine and CP elements, the following elements may 
appear in any order: 

■ A card read routine. This could be either the online serial card reader routine, 
named XRDR, or the Card Controller routine, named XRDC. If XRDC is used, 
then an EQU card of the form: 



LABEL 


OPERATION 


OPERAND 


RDCN 


EQU 


n 



should be included with the other EQU cards in the input deck, where 'n' is the 
number of the channel on which the Card Controller is located. 
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An input translation table. To allow the user to punch source code in any card 
code that he wishes, the Compressor uses a user-supplied translation table to 
translate from card to internal code. The Compressor assumes that the result 
of the translation is EBCDIC. The input translation table supplied must be 
labeled RDTT If source code cards are punched in Hollerith, then the UNIVAC 
supplied Hollerith to EBCDIC translation table, which is named TBRD, can be 
used. In this case, an EQU card of the form: 



LABEL t OPERATION* OPERAND * 
1 10 16 


R|D,T|T| | | | 




ElQiUi i 




oi. itibirIdi I 1 1 1 1 1 1 1 1 t 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 




1 . . . 




1 1 1 1 1 1 1 ! 1 1 1 1 1 1 ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 













should be included with the other EQU cards in the input deck. 

A card punch routine. This is either the online serial punch routine, named 
XPCH, or the row punch routine, named XPRW. If XPRW is used, then an EQU 
card of the form: 



LABEL 


OPERATION 


OPERAND 


CHAN 


EQU 


n 



should be included with the other EQU cards in the input deck, where 'n' is the 
number of the channel on which the row punch is located. 



■ The Systems Programming internal routine for the printer, XPRT. 

■ If the PRTR EQU cards has been used to specify a value of TBPR, the UNIVAC 
supplied EBCDIC to 48- character-print-code translation table, which is named 
TBPR. 

Blank card separators may be placed between the elements in the input deck, 
as the Linker ignores blank cards. 



The operand field of the END control card used when the Compressor is linked 
must be: 0,INIT 
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A13.5. Operating Instructions 

1. Place the Compressor deck in the reader. 

2. Home paper; clear the reader, punch, and printer. 

3. Load the Compressor deck. 

4. Stop X'lFFF'. 

5. Place the macro definition source cards in the reader. Follow these cards 
by an end sentinel card and two blank cards. 

6. Depress the START switch. 

7. Stop X'lFFF' 

Punch output hopper contains the Macro Library. 

8. To process another library, return to Step 5. 

A13.6. Control Card 

When the Compressor is being run from initial load, the macro definition source 
card deck may be preceded by a control card, which contains CTL in columns 
10, 11, and 12, and a decimal number beginning in column 16. The number may 
take any value between 8191 and 32767. If a control card is present, the decimal 
number tells the Compressor the memory size in which it is to operate. If the control, 
card is absent, or if the value specified lies outside the permissible range, the 
Compressor assumes that it is to operate in a 16K memory. 
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APPENDIX B. INPUT/OUTPUT CONTROL 

SYSTEM (IOCS) 



Bl. GENERAL DESCRIPTION 

The Input/Output Control System (IOCS) provides the user with tested input/output 
routines to control the data which are the input or output of programs written in Assem- 
bler language. IOCS consists of two parts: 

(a) the input/output routines themselves, which are macros and generated as a result 
of macro calls. The macros used to generate the input/output routines are called 
declarative macro instructions. 

(b) the macro instructions used by the worker program to communicate with the input/ 
output routines. These macro instructions are called imperative macro instructions. 

B2. GENERAL USAGE 

The user is provided with a complete set of routines for controlling all input/output 
operations required by the system. Since not every source program requires every 
routine or its variable functions, Univac Division of the Sperry Rand Corporation 
provides a Preassembly Macro Pass program which in effect is a generator capable 
of adapting each input/output routine to the requirements of the user. 

The Preassembly Macro Pass first reads declarative macro instructions made by the 
user describing the input/output operations required by the application. Based on these 
instructions the Preassembly Macro Pass selects the required routines from the macro 
library, develops them for the specific application, and punches them into cards in the 
Assembler language format. They may then be assembled as part of the source program 
or assembled separately and linked with the user program at linker time. This function 
is provided by the UNIVAC 9200/9300 Card Linker program. 

The user communicates with the IOCS routines through use of the macro calls (imperative 
macro instructions) in his problem program. Typical imperative macro instructions are 
OPEN, CLOSE, GET for an input file, and PUT for an output file. These imperative 
macro instructions are related to the input/output routine to which they refer by means 
of a file name. The same file name appears as a parameter in all of the imperative 
macro instructions referring to one file and also appears as the label of the declarative 
macro instruction generating the input/output routine for the file. 
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B3. DEFINITION STATEMENTS (DECLARATIVE MACROS) 

The programmer must use definition statements to describe to the Preassembly Macro 
Pass the characteristics of the particular input/output file to be processed. These 
statements are then used by the macro pass to specialize the particular input/output 
routine to meet the requirements of the file and the program. 

Each input/output device required by the program must be defined by rrsans of these 
definitions. A definition statement is herein defined as consisting of one Header Entry 
card and a number of Detail Entry cards. In a definition statement, each header and 
detail entry card must have a character punched in column 72, except the final detail 
entry card which must not contain this continuation character in column 72. 

B3.1. Header Entry Card 

A header entry card is the first card of a definition statement and requires three items of 
information. The first is the symbolic name of the file assigned by the user and is entered 
in the label field of the card. The symbol may consist of as many as four characters and 
must adhere to the Assembler language rules for labels. The second item is written in the 
operation field and must be one of the following: 

1. DTFCR - DEFINE THE FILE FOR THE CARD READER 

2. DTFPR - DEFINE THE FILE FOR THE PRINTER 

3. DTFRP - DEFINE THE FILE FOR THE READ/PUNCH 

4. DTFCC - DEFINE THE FILE FOR THE CARD CONTROLLER 

5. DTFRW - DEFINE THE FILE FOR THE ROW READ/PUNCH 

The third item is a keyword parameter specification, described in Section B3.2, 
and is entered in the operand field. 

For example, the header entry card for a reader routine with a file named "MSTR" 
would appear as follows: 

LABEL OPERATION OPERAND 



MSTR 



DTFCR 



keyword = specification 



B3.2. Detail Entry Cards 



The detail entry cards are used to define parameters such as mode of processing, buffer 
area name, and print bar. 

Each detail entry card is composed of a keyword immediately followed by an equal (=) 
sign which is in turn followed by one specification. A comma must immediately follow 
the specification for each detail entry card in the definition statement except for the final 
detail entry card. A given detail entry must be used only once in each definition statement. 
Entries which do not apply to a particular application should be omitted. The summary of 
detail entry cards listed in Appendix B4, gives the optional as well as the required 
detail entry cards for a given peripheral device. The format for a detail entry card, 
with the continuation character in column 72, is as follows: 



LABEL 


OPERATION 


OPERAND 


72 


symbol 


DTFxx 


keyword=specification, 


X 
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B3.2.1. Block Size Entry (BKSZ) 

This entry must be provided for all printer files. The keyword is BKSZ. Any number 
from 1 through 132 may be specified, but the number should be no larger than the number 
of print positions available. The user-defined work area where print images are made 
available to IOCS must contain the same number of bytes as is specified for BKSZ. 
IOCS left justifies the print images on the printed line and supplies spaces for printing 
in the remaining unspecified print positions. The keyword and specification for 132 
print positions have the following form in the operand field: 

BKSZ=132 
B3.2.2. Channel Entry (CHNL) 

This entry is used to define the general purpose channel to which the UNIVAC 1001 
Card Controller or the Row Read/Punch is connected. The keyword is CHNL; the 
allowable specification is one of the general purpose channels 5 through 12. The 
keyword and specification for a channel entry for general purpose channel 5 have 
the following form: 

CHNL=5 

B3.2.3. Control Entry (CNTL) 

This entry must be provided for all files to which a CNTRL macro instruction is 
directed in the main program. 

The keyword is CNTL. The specification is YES. 

CNTL=YES 

CNTL is a detail entry card within a definition statement. CNTRL is an imperative 
macro and its use is described in a later section. 



B3.2.4. End-of-File Address Entry (EOFA) 

This entry is used to specify the symbolic name of the end-of-file routine provided 
by the user. The keyword is EOFA and the specification is the symbolic name of 
the user end-of-file routine. The format for an end-of-file routine labeled END is as 
follows: 

EOFA=END 

If the image to be delivered is an end-of-file card, IOCS jumps unconditionally to the 
user end-of-file routine when a GET macro instruction is issued for an input file. 

An end-of-file card contains a slash (/ [0-1 punch]) in column one and an asterisk in 
column two. (In actuality, the card system IOCS routines recognize an end-of-file card 
by means of the slash in column one alone.) An end-of-file card must be followed by 
other cards in the input hopper to avoid a hopper empty indication before the end-of- 
file card is sensed. The following cards may be special if the user has some purpose 
for them (such as an overlay to be loaded); otherwise, their content is not significant 
and any cards the user wants may be used (such as blank cards or more end-of-file 
cards). 
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For the online card reader, when control is transferred to the user end-of-file address, 
the end-of-file card image is in the work area and the image of the card immediately 
following the end-of-file card is in the input area. 

The EOFA parameter is not applicable to the UNIVAC 1001 Card Controller. The 
user must test for his own end-of-file. 

B3.2.5. The Function Entry - UNIVAC 1001 Card Controller (FUNC) 

This entry specifies the symbolic name of a one-byte user-defined area where the 
hexadecimal value for the required function is stored before each GET or PUT 
macro instruction. 

The keyword is FUNC. The specification is the label of the one byte user area, and 
for a function area labeled CCXF, has the following form: 

FUNC^CCXF 

B3.2.6. Allowable Functions for the UNIVAC 1001 Card Controller 

The following table illustrates the allowable hexadecimal values which may be 
stored into the user-defined one-byte area before each GET or PUT macro instruc- 
tion is issued. Once set, the area may remain the same or be altered as desired. 



HEXADECIMAL VALUE 


FUNCTION SPECIFIED 


08 


Transfer and Read Primary 


09 


Transfer and Read Secondary 


00 


Transfer Primary 


01 


Transfer Secondary 


02 


Transfer Primary and Secondary 


0A 


Transfer and Read Primary and Secondary 


24 


Send Data to 1001 (1001 code only) 


14 


Receive Data from 1001 (1001 code only) 



The GET macro is used with all functions but "Send Data to 1001". With this func- 
tion a PUT macro is used. 
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B3. 2.6.1. Transfer-and-Read Functions 

The previous image read into the UNIVAC 1001 Card Controller is transferred 
into the UNIVAC 9200/9300 memory and another image is read into the UNIVAC 
1001. The function for the first GET executed after opening a Card Controller 
file should be a transfer-and-read function which, in contrast to the general 
case, causes the first card in the feed specified to be read and transferred, 
and the second card to be read. 

B3.2.6.2. Send-and-Receive Data Functions 

These functions are not available on the standard board. However they are pro- 
vided for by IOCS in the event the user wishes to wire his own board for 
a particular application. 

No translation is provided for these functions and they must be performed in 
UNIVAC 1001 mode only. 

The user work area must contain one byte more than is required for the data to 
be sent or received. The extra byte must be the first byte of the area and must 
contain the number of characters to be transmitted. This first byte must not be 
in UNIVAC 1001 mode, but must contain a binary number. 

Typically, the data sent to the UNIVAC 1001 contains some function character the 
-modified board is to interpret, as well as data to be used in the execution of the 
function. 

For example, assume the board has been modified to interpret the code of a hexa- 
decimal value of 77 as a search primary for a name. The following steps implement 
this function: 

(1) Set function entry area to a send-data function. 

(2) Store hexadecimal 77 into the second byte of the work area. 

(3) Store name (assume 6 characters) in work area bytes 3 through 8. 

(4) Store a binary 7 (6+1 function) into first byte of the work area (the number 
of characters to be transmitted). 

(5) Issue a PUT macro instruction. 

When the UNIVAC 9200/9300 program receives the data the UNIVAC 1001 has 
developed as a result of performing this search, the following steps are taken: 

(1) Set the function entry area to a receive-data function. 

(2) Store the number of characters to be received in the first byte of the work 
area. 

(3) Issue a GET macro instruction. 

The data will be received in byte 2 and the following bytes of the work area. 
Typically, the data received from the UNIVAC 1001 contains some status 
character (find/no-find, for example) and the data requested by the preceding 

Qj^nrl-rlota funrHnn. 
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The nature of any function or status characters embedded in data to be sent or 
received and the location of these characters in the data message is a user 
responsibility. The IOCS system makes no attempt to control the information 
content of data sent or received. 

B3.2.7. Input Area Entry (IOAl) 

This entry specifies the name of the input buffer area. In the UNIVAC 9200/9300 
Card System, it is used only for the reader file. The keyword is IOAl. The speci- 
fication is the symbolic name of the input buffer area assigned to the device. This 
symbolic name must be the symbol used by the programmer in the DS statement de- 
fining the area in his main program. 

IOAl=CARD 

In this instance, CARD is the symbolic name of the input buffer area. The symbolic 
name assigned by this entry is never referenced directly by the programmer. Images 
are delivered by the input/output routines into a specified work area. 

B3.2..8. Input Area Entry (INAR) 

This entry is used to specify the symbolic name of the user-defined input buffer area 
when the read feature of the read/punch unit is required. The keyword is INAR. The 
specification is the symbolic name of the area assigned to the read/punch unit as 
defined by the programmer. The operand for a read/punch buffer area labeled INPC 
has the following form. 



tNAR=INPC 



B3.2..9. Input Translate Table Entry (ITBL) 



This entry specifies the symbolic name of a translate table located in the main 
gram by which all records of a given input file are to be translated. 

The keyword is ITBL and the specification is the symbolic name assigned by the 
programmer to the table. The operand fbr a translate table labeled CODE has the 
following form: 

ITBL = CODE 



B3.2.10. Mode Detail Entry (MODE) 

This entry is used to specify the mode of the input/output file and is required as 
part of the definition statement for all devices but the printer. The keyword of the 
entry is MODE. The allowable specifications are: 
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OPERAND FORM 


REMARKS 


MODE=BINARY 


For cards read and/or punched in column 




binary mode. 


MODE=CC 


For cards read and/or punched in compressed 




code (80-byte I/O area required). 


MODE = 1001 


For cards read in UNIVAC 1001 mode with- 




out translation (Card Controller only) (80- 




byte I/O area required). 


MODE=TRANS 


For cards to be read and/or punched trans- 




lated by the table specified by the ITBL 




or OTBL entry. 


MODE=TRANSTC 


For Card Controller only, if translation of 




UNIVAC 1001 code is required through the 




translation table specified by the ITBL entry 



There are two translation modes which may be defined with the UNIVAC 1001 Card 
Controller. 

■ TRANS, implies all cards read into the UNIVAC 9200/9300 from the UNIVAC 1001 
are translated from compressed code by the translate table specified by the ITBL 
detail entry card. 

■ TRANSTC, implies all cards read into the UNIVAC 9200/9300 from the UNIVAC 
1001 are translated from 1001 code by the translate table specified by the ITBL 
detail entry card. This mode is used when combined reading (both primary and 
secondary in one function) is required, since basic UNIVAC 1001 memory cap- 
ability is exceeded if two images are read in other than 1001 code. 

For the online serial card reader operating in translated mode, card images are read 
into the input area in compressed code, moved to the work area, and translated there. 
For example, when control is transferred to the user end-of-file address, the image 
of the end-of-file card is in the work area in translated mode, and the image of the 
card immediately following the end-of-file card is in the input area in compressed 
code. 

For the Card Controller operating in translated mode, card images are read into the 
work area in compressed code and are translated in the work area. 

B3.2.11. Output Area Entry (OUAR) 

The entry specifies the symbolic name of the output buffer area as defined in the 
main program when the punch function of the punch, read/punch unit, is required. 

The keyword is OUAR. The specification is the symbolic name assigned by the 
programmer in the DS statement defining the area. The operand for an output area 
labeled OUPC has the following form: 



OUAR=OUPC 
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There is no need to define an output buffer area for the printer, since IOCS uses 
the print buffer area in restricted memory. 

B 3.2. 12. Output Translate Table (OTBL) 

The entry specifies the symbolic name of the translation table located in the problem 
program through which all output images are to be translated. 

The keyword is OTBL. The specification is the symbolic name assigned to the 
table. The operand for a translation table labeled CRDC has the following form: 



OTBL^CRDC 



B 3.2. 13. Overlap Entry (ORLP) 



This entry specifies that the read/punch unit file is to be processed in an overlap 
mode and applies only to the read/punch unit when used as both a reader and a 
punch. The entry is omitted when information is to be punched in a card which has 
been read previously. 

The keyword of this entry is ORLP and the specification is YES. The operand has 
the following form: 

ORLP =YES 

B3.2.14. Print Bar Entry (FONT) 

The entry specifies the print bar the program expects to find in the user configura- 
tion. The keyword is FONT and the allowable specifications are 48 or 63. The 
operand for a 63-character print bar has the following form: 

FONT = 63 

When using a UNIVAC 9300 System with a 16-character print bar, FONT=48 should 
be specified. Numeric printing must be specified in the CNTRL macro instruction 
(B6.7.4); an alphanumeric print may damage the print bar. 

B3.2.1S. Printer Advance Entry (PRAD) 

This entry is used in conjunction with printer files and enables the programmer to 
specify a standard advance of one or two lines. 

The keyword is PRAD. The allowable specifications are 1 or 2. The operand for 
double spacing has the following form: 

PRAD =2 



B3.2.16. Punch Error Entry (PUNR) 

This entry specifies that automatic error recovery, where possible, is to be provided 
in the online serial or row punch routine and applies only to these devices. If it is 
not specified, all punch errors bring the computer to a stop. 

The keyword is PUNR. The allowable specification is YES. The operand has the 
following form: 

PUNR =YES 
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B 3.2.17. Printer Overflow Entry (PROV) 

This entry must be provided if the user wants any special action as a result of 
form overflow on the printer. If the printer overflow entry is not provided, printer 
spacing proceeds as directed by the printer advance detail entry and/or the CNTRL 
macro specifying skipping or spacing. 

The keyword of the entry is PROV. The specification may be either YES or a label. 
The operand has the following form: 

PROV =YES 
or 

PROV = label 

If the specification is YES, an automatic skip to channel 7 (home paper) in the 
paper tape loop is provided in response to form overflow. 

If the specification is a label other than YES, control is transferred unconditionally 
to the specified label in response to form overflow. The label specified should be 
the symbolic name assigned to the user overflow routine provided to perform the 
desired form overflow action. 

The user indicates the point at which form overflow is to occur by a channel 1 punch 
in the paper tape loop. The form overflow punch (channel 1 punch) is recognized 
when spacing paper, either in response to a CNTRL macro specifying spacing before 
printing or in response to a PUT macro after printing a line. (The form overflow punch 
is not recognized during a printer skip operation.) 

Response to recognition of a form overflow punch may be illustrated by the following 
sequence of operations: 



(1) 



(2) 



(3) 



(or 



(or 



(or 



RET 



PUT 


FILA 


CNTRL 


FILA,SP,m,n 


• Process 




PUT 


FILA 


CNTRL 


FILA 


• Process 




PUT 


FILA 


CNTRL 


FILA 


• Process 





m/0) 
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If the form overflow punch is recognized during the spacing associated with (1), 
then after (3) is executed, the form overflow action specified is taken. If the action 
is to transfer control to a user subroutine, then control goes to that subroutine 
rather than to the label RET. The address of the label RET is in general register 14 
when control is transferred to the form overflow subroutine. 



B 3.2. 18. Type of File Entry (TYPF) 

This entry indicates whether the file is an input, output, or a combined file. It is 
applicable only to the UNIVAC 9200/9300 Read/Punch Unit. 

The keyword of the entry is TYPF. The allowable specifications are given below. 



OPERAND FIELD 


COMMENTS 


TYPF = INPUT 


Reading only 


= OUTPUT 


Punching only 


^COMBND 


Reading and punching 
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B4. SUMMARY OF DETAIL ENTRY CARDS 



OPERANDS FIELD 


APPLIES TO 




rr 

LLl 

Q 

< 

LLl 

rr 


rr 

LU 

l- 
z 

rr 
o_ 


SERIAL 

READ 

PUNCH 


ROW 

READ/ 

PUNCH 


CARD 
CON- 
TROLLER 




KEYWORD 


ALLOWABLE 
SPECIFICATION 


REMARKS 


BKSZ 


1-132 




X 








Required for online printer 


CHNL 


5 thru 12 








X 


X 


Required for UNIVAC 1001 


CNTL 


YES 




X 


X 


X 


X 


Required if CNTRL macro is used 


EOFA 


Symbolic name of user 
end-of-file routine 


X 




X 


X 




Applies to input files only 


FUNC 


Symbolic name of user 
defined 1-byte area where 
function is stored 










X 


Required by Card Controller 


IOA1 


Symbolic name of user 
defined input buffer area 


X 










If binary image requested, 160-byte area 
required 


INAR 


Symbolic name of user 
defined input buffer area 






X 


X 




Required if reading in the read/punch file 


ITBL 


Symbolic name of user 
defined input translate 
table 


X 




X 


X 


X 


Required if translation of input file desired 


MODE 


See Appendix B,3.2.10 


X 




X 


X 


X 




OUAR 


Symbolic name of user 
defined output buffer area 






X 


X 




Required for punch files and read/punch files 


OTBL 


Symbolic name of user 
defined output translate 
table 




X 


X 


X 




Required if translation of output file desired 


ORLP 


YES 






X 


X 






FONT 


48 or 63 




X 








Specifies 48- or 63-character print font 


PROV 


YES or symbolic name of 
user form overflow routine 




X 








Required if form overflow action is to be taken 


PRAD 


1 or 2 




X 








Specifies standard print advance 


PUNR 


YES 






X 


X 




Automatic error recovery desired 


TYPF 


INPUT 

OUTPUT 

COMBND 






X 
X 
X 


X 
X 
X 




Reading only 
Punching only 
Reading & punching 
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B5. DEFINITION STATEMENT EXAMPLES 

The following are examples of definition statements. 

B5.1. Online Serial Punch File Example Definition 



LABEL 



. OPERATION t> 
10 16 



OPERAND 



D|T,F, R,P 



J _____ _ 



C 1 N i _T J L i =!Y ! E : S 1 _ Ji 1 , . , j_L^„.j 
MjO,p 1 E_ ? =l_T i R 1 A 1 N,SJ. J . . 
0, IB, L-=|M, T : C- _C_., 1 i ... 
0, U, A R, =( PUN, C, , 1 



T, Y, P F -OUT, P, U!T, 



COMMENTS 


72 




80 


J Li......!.. LI J.... 

l_Lj_l_i j._L 


X 

x 
x 

X 


1 i .!_.. _J L.. 

L . _A_1____L.._ 

; :__!______! 


_!.. . 

__i_ 
i 


; 1 i , : ! 


i I i i i ' i 


: , 1 : . 


L.J I L. .J._i_ ! - 




..__._._- 1_L_L_ 


i .. _ 



B5.2. Reader File Example Definition 



LABEL 



* OPERATIONS 
10 16 



OPERAND 



COMMENTS 



72 



80 



I |N,P,U 



_l_l I I L_L 



J l_l L__l I L 



_L_J_LJ L_l L 



DIT.F.CR 



J L 



L 



J L 



ELpi.FiA 1 .=i.Ei.N L Pi...M.l i_i.___ l__L_,._._. i_.i._i. 
I jOj A, 1 , =i C. A, R, D, ,\ ; , , _, ! : j_..i.._i__L 

LlIiBlki-dCjJ, A.Cl» J. _____ _L _.i__.._J_._±_i_.L 



M l°i p i E -^L T i R ; A i N i s i i : i 



A_| I I I I I L L 

L.J i 1_._L_-L....!. 

J J_._L.J_L-.-: .J 



J I I L 



B5.3., Printer File Example Definition 



LABEL . OPERATION. OPERAND 
1 10 16 


___ij.__jTj Ai j 




.P1.TiFl.PjR 

_L .1 L . !.__ 

I 1 1 I 


_ 


CiNiT_L_^1YiE 1 S_ j .i...1_l_.i_.i 


i i i i 1 i i 


F,O l N l T l H4,8,, i,|,,, 


i i i i 1 i i 




.^J_L D l.__L____.__J_ L._L_L.J. JL 


i i i i I i i 




1 1 1 I 




P l R l 1 V ! _=|Y,E,S, , 1 , , , 


i i i i 1 i i 




1__I _______ 

...L._L. .___!_. 


- 


OlTlB^L^-jP^BAlBj,! , ^ 


i i i i 1 i i 




_________ L_±__LL 3 ___L ,__L.l J __. 









COMMENTS 



72 



1 X 



J. _ J__.l_.i_ 

_1_1 I L_J__ 

_l I I I L_ 



I J 1- 

_..±_.__ 



_____ Jx 

A A 



J L 



80 



...i .j— j . 

L I 1.. 



J_______L. 

J I L 
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B5.4, Online Serial Read and Punch File Example 



1 


LABEL * OPERATION * OPERAND// 
10 16 (\ 


B,l 


iL,L, | , , 




D|T,F,R,P 




CNiT. Li-IY,E,S... 1 , ) 












E|0.F.A,«|F|l ,Ni, i 1 i j 












IiN,A i R i .|R,EiA,Di. 1 i / 












l,T l B 1 L,-|C l T l M 1 C lf | , V 












M 1 1 D 1 E,-|T l R l A 1 N l S|. 1 / 












0,U 1 A l R 1 =|F l U,N ! C l , | , ) 












1 T l B 1 L 1 =|M 1 C,T,C 1 , | , ( 












T l Y l P,F l -|C,O l M,B l N|D| ,\ 



72 



80 



-1-. l_-l 1 l_ 

-L. 1 _J_L_L. 



1 



l i i 



__L_J I L 

_L_J I L 



J J 1_ 



J I L_L 



B5.5. Card Controller File Example 



1 


label t OPERATION t 

10 16 


OPERAND/y 


Si- 


fciL.S, | , , 




DlT.FiCC 




Q N| T| L| = 


Y.E.S,., 1 , / 








1. . . 




1 iT 1 B,L,= 


|B,C,D lf , | , 7 








1 . . . 




F.U.N.C,. 


R.E.Q.S,. | , ( 








I... 




M.O.D.E,^ 


IT.R.A.N.SI,, \ 








1 i . i 




C,H|N|L| = 


1 5, ' , , , | , / 

















72 



80 



-J I I L 



-I L—l .„i_. 

J I.I I 



B6. IOCS MACRO INSTRUCTIONS (IMPERATIVE MACROS) 

This section describes the format, function, and use of the IOCS macro instructions 
used to communicate with the input/output routines and to control their operations. 
These symbolic instructions are used in the problem program to provide the communication 
necessary with the IOCS routines previously defined by means of the definition statements 
to the Preassembly Macro Pass. The handling of records into and out of I/O areas is 
performed by IOCS exclusively. Each file is processed in the manner dictated by the 
definition statement. 

Source programs using IOCS may not contain any Assembler I/O instructions. 

The format of the macro instruction follows the rules of the Assembler coding format. 
The macro verb is the operation, and the operand field may contain up to four param- 
eters as required by the particular macro. All macros may have a label. The impera- 
tive macro instructions are not handled by the Preassembly Macro Pass but are 
processed by the Assembler itself. 

B6.1. GET Macro Instruction 

The GET macro makes the next record available in the user-defined work area or 
transfers control to the end-of-file address entry upon recognizing an end-of-file card 
in an input file. 
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The GET macro has the following form 



LABEL 



OPERATION 



GET 



OPERAND 



filename, workarea 



where "filename" is the symbolic name defined in the label field of a DTF(XX) 
header entry card. 

"workarea" is the symbolic name of the user-defined storage where the 
record is made available for output. 

B6.2. PUT Macro Instruction 

The PUT macro transfers a record from the work area for printing, punching, or sending 
to the UNIVAC 1001 and immediately frees the work area for problem program use. 

The PUT macro has the following form 

OPERATION OPERAND 



PUT 



filename, workarea 



where "filename" is the symbolic name defined in the label field of a DTF(XX) 
header entry card. 

"workarea" is the symbolic name of the user-defined storage where the 
record is made available for output. 

B6.3. Work Area Considerations 

The imperative macro instructions, GET and PUT, require as a second parameter the 
symbolic name of a work area for transferring records from and to input/output buffer 
areas. Input/output areas (those assigned by IOAl, INAR, and OUAR detail entry 
cards) may not be used as work areas as they are used by IOCS to maintain standby 
reserve areas. 



The programmer must therefore provide, through the use of DS statements, work areas 
where records are processed. These work areas may be common to more than one file 
as efficiency demands, but must be as large as the largest record to be processed 
therein. 

B6.4. Programming Considerations — Read/Punch Combined File 

When the Overlap detail entry card is used for a read/punch combined file, the follow- 
ing rule applies: 

A PUT macro instruction causes punching into the card which follows the one 
made available by the last GET macro instruction, because the card made avail- 
able by the last GET macro is already past the punch station when the PUT 
macro is given. 

When the Overlap detail entry card is omitted for a read/punch combined file, a PUT 
macro instruction causes punching into the card made available by the last GET macro 
instruction. It should be noted that in this nonoverlap mode, the read/punch unit is cycled 
on PUT's only; therefore, successive GET's must be separated by at least one PUT. 
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B6.5. OPEN Macro Instruction 

This macro instruction initializes the file and must be issued before any other macro 
instruction pertaining to the same file. 

The OPEN macro has the following form: 

OPERATION OPERAND 



OPEN 



filename 



where "filename" is the symbolic name defined by the user in the label field 
of the DTF(XX) header entry card. 

After a file has been OPENed, it should be CLOSEd before reOPENing the same file. 
In such a case, the input/output routine is set back to an initial state. As as example: 

1. For an input file, the card image delivered in response to the first GET executed 
after a second OPEN macro is the image immediately in front of the read station 
at the time the second OPEN macro is given. 

2. For an output file, the first item transmitted after the second OPEN macro is the 
item delivered by the first PUT executed after the reOPEN. 

B6.6. CLOSE Macro Instruction 

This macro instruction insures the proper closing of all files. The CLOSE macro has 
the following form: 



OPERATION 



CLOSE 



OPERAND 



filen 



ame 



where "filename" is the symbolic name defined in the label field of the DTF(XX) header 
entry card. 

B6.7. CNTRL Macro Instruction 

The CNTRL macro is used by the programmer for printer spacing, printer skipping, 
stacker selection, numeric printing, and specifying the number of columns of card 
punching. 

B6.7.1. Printer Spacing 

The CNTRL macro for printer spacing has the following form: 



OPERATION 



CNTRL 



OPERAND 



filename, SP,m,n 
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where "filename" is the symbolic name of the file defined in the label field of 
the DTFPR header entry card. 

SP specifies spacing. 

m is the number of lines to space the form before printing (m=0, 

1 or 2). 

n is the number of lines to space the form after printing (n=0,l or 2). 

The programmer may omit "m" or "n". If no CNTRL macro instruction specifying delayed 
spacing is given before the next PUT macro for the printer file, the printer advances the 
standard amount as specified in the PRAD detail entry card of the definition statement. 

If more than one CNTRL macro specifying paper movement after printing is given 
between PUT macros to the printer file, only the last CNTRL macro is effective. 

B6.7.2. Printer Skipping 

The CNTRL macro for printer skipping has the following form: 



OPERATION 



CNTRL 



OPERAND 



filename, SK,m,n 



where "filename" is the symbolic name of the file defined in the label field of the 
DTFPR header entry card. 



SK 



m 



specifies skipping 

is the number of the tape channel the carriage is skipped to 
before printing (m=l,2....7). 



n is the number of the tape channel the carriage is skipped to 

after printing (=1,2.. ..7). 
The programmer may omit "m" or "n". Between PUT macros, only the last CNTRL 
macro specifying paper movement after printing is effective. 

Due to timing conditions, throughput is maintained at the best possible level if 
delayed spacing and skipping are used where possible. 



B6.7.3. Stacker Select 



The CNTRL macro for selecting other than the normal stacker on the serial punch, 
read/punch, or for selecting any stacker on the card controller has the following 
form: 



OPERATION 



CNTRL 



OPERAND 



filename, SS,n 



where "filename" is the symbolic name of the file defined in the label field of 
the header entry card. 



SS 



specifies stacker select. 

is the stacker number where the card is to be selected on the 
card controller only. Allowable values are specified in the 
following table. 
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FEED 


PRIMARY 


SECONDARY 


1 2 3 C 
12 3 4 


1 2 3 C 

5 6 7 8 



Stacker 
Specification (n) 



NOTE: If this CNTRL macro is not given for the UNIVAC 1001, primary feeds are 
selected to PI and secondary feeds to SI. 

The CNTRL macro for Card Controller stacker selection operates under the following 
rules. The card made available by a transfer-and-read from a particular feed is selected 
on the next transfer-and-read from that feed. The card made available by a transfer 
only from a particular feed is selected on the second following transfer-and-read from 
that feed. If the user issues a CNTRL macro after receiving a particular card image, the 
CNTRL macro governs the stacker selection for that particular card, regardless of the 
sequence of operations following that CNTRL macro. If no stacker is selected from a 
card in the manner described here, the card will be put in the normal stacker, which is 
PI for the primary feed and SI for the secondary feed. 

The CNTRL macro instruction for selecting a stacker on the read/punch should 
be executed before the PUT for the card to be selected, or in the case of reading 
only, after the GET for the card to be selected. If the CNTRL macro instruction 
is to be used for selecting a stacker when both reading and punching, and if 
stacker selection is done on the basis of information in the card read, the read/ 
punch routine must be operated in the no overlap mode. 

B6.7.4. Numeric Printing 

The CNTRL macro instruction for numeric printing enables the programmer to maintain 
maximum printing speeds. Once set, it remains set until and unless another numeric 
print CNTRL macro is given specifying that alphanumeric printing is requested. 

The CNTRL macro instruction for numeric printing has the following form: 



OPERATION 



CNTRL 



OPERAND 



filename, NP,m 



where "filename" is the symbolic name of the file as defined in the label field 
of the DTFPR header entry card. 

NP specifies a change in the mode of printing. 

m is mode of printing requested. 

m - 0, alphanumeric printing required. 

m = 1, numeric printing required. 

NOTE: Alphanumeric printing is assumed by IOCS if no CNTRL macro is given. 

The CNTRL macro instruction should be used only in conjunction with a 
48- or 16-character print bar. 
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B6.7.5. Specifying Columns to be Punched 

The CNTRL macro instruction enables the programmer to vary or alter the number of 
columns punched in the punch file. This function enables the punch to run at maximum 
speed for the particular application. Once set by the macro, the number of columns 
punched remains the same unless or until another such macro is given. If no CNTRL 
macro is given, IOCS assumes a full card is required. 



The CNTRL macro for punching has the following form 



OPERATION 



CNTRL 



OPERAND 



filename, NC,n 



where "filename" is the symbolic name of the file defined in the label field of 
the DTFRP header entry card. 



NC 



identifies a number-of-columns specification. 



n is the number of columns to be punched (an even number 

2, 4, 6. ..80). 

B6.8. Summary of UNIVAC 9200/9300 Card System IOCS Imperative Macros 









DEVICE ADDRESSED 


LABEL 


OPERATION 


OPERANDS 


READER 


PRINTER 


SERIAL 
READ/ 
PUNCH 


ROW 
READ/ 
PUNCH 


CARD 
CONTROLLER 


OPTIONAL 


OPEN 


filename 


X 


X 


X 


X 


X 


GET 


filename, workarea 


X 




X 


X 


X 


PUT 


filename, workarea 




X 


X 


X 


X 


CLOSE 


filename 


X 


X 


X 


X 


X 


CNTRL 


filename, SP, m, n 




X 








CNTRL 


filename, SK, m, n 




X 








CNTRL 


filename, NP, m 




X 








CNTRL 


filename, NC, n 






X 


X 




CNTRL 


filename, SS, n 






X 


X 


X 
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B7. PROGRAMMING CONVENTIONS - PROGRAM REGISTERS 

A user routine may be required in the main source program that is accessed by IOCS 
when certain checking features are required (for example, printer overflow). IOCS 
automatically stores the program re-entry address in register 14 when the branch to 
the user routine occurs. The user routine is therefore required to provide the necessary 
return linkage to the main source program. If the user routine uses register 14, it must, 
therefore, preserve and restore register 14 before terminating. This must also be done 
if any macro instruction is executed by the user routine, since all macros use program 
registers 14 and 15. If register 14 is not preserved, the re-entry address is lost. Register 
15 may also be used by the user routine and it need not be preserved. However, its con- 
tents are altered by the execution of any macro instruction. 

B 8. GENERAL PROCEDURE SUMMARY FOR USING IOCS 

The programmer defines his input/output control routines and their associated files 
through the use of definition statements presented to the Preassembly Macro Pass 
program. The generated I/O routines are then either assembled as part of the main 
source program or assembled separately and linked with the main program at load 
time. If the I/O routines are assembled independently, the user must supply 
appropriate USING directives; no USING directives are generated by IOCS. 
During the execution of the main program, input/output functions are accomplished 
through the imperative macro calls. 

B9. STORAGE REQUIREMENTS 

The IOCS routines require the use of EXEC I. The following two charts show the 
storage requirements for the IOCS routines. 



DEVICE 


MODE OF 


STORAGE 




OPERATION 


REQUIREMENT 


EXEC I 


- 


180 


Reader 


- 


150 


Printer 


- 


330 


Serial Read/Punch 


- 


- 


Read 


- 


190 


Punch 


- 


260 


Read/Punch 


No overlap 


330 


Read/Punch 


Overlap 


340 


Card Controller 


- 


720 


Row Read/Punch 


- 


- 


Read 


- 


360 


Punch 


- 


400 


Read/Punch 


No overlap 


530 


Read/Punch 


Overlap 


560 



UP-4092 
Rev. 2 



UNIVAC 9200/9300 
CARD ASSEMBLER 



Appendix B 



SECTION: 



20 



MACRO INSTRUCTION 


STORAGE REQUIREMENT 


OPEN 

GET 

PUT 

CNTRL 

CLOSE 


4 
6 
6 
8 
4 



B10. APPROXIMATE TIMES FOR IOCS ROUTINE EXECUTION 

The following chart shows the approximate execution times (in milliseconds) required for 
the various IOCS macro instructions on the UNIVAC 9200. The UNIVAC 9300 execution 
times are one half the UNIVAC 9200 execution times. 



DEVICE 


MODE OF 
OPERATION 


TIME REQUIRED 
(IN MILLISECONDS) 


Reader* 


— 


GET PUT 

5 


Printer 


- 


4 


Serial Read/Punch 


- 


- - 


Read* 


- 


5 


Punch* 


- 


5 


Read/Punch* 


No overlap 


5 5 


Read/Punch* 


Overlap 


5 5 


Card Controller* 


- 


5 


Row Read/Punch 


- 


- 


Read* 


- 


7 


Punch* 


- 


7 


Read/Punch* 


No overlap 


5 7 


Read/Punch* 


Overlap 


7 8 



*Translation time included. 
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Bll. CARD READER DEFINITION STATEMENTS 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFCR 


EOFA = location of the user end-of-file 
routine, 


X 






IOA1 = location of the input buffer area, 


X 






ITBL = location of the input translate 


X 






table, 








MODE = BINARY 








or 








MODE = CC 








or 








MODE = TRANS 





ITBL is required if MODE = TRANS. 

EOFA, IOA1 and MODE must always be present. 

The input buffer area and word area are each 80 bytes long, if MODE = CC or TRANS, 
and 160 bytes long if MODE = BINARY. 

At the time control is unconditionally transferred to the end-of-file routine, both the 
end-of-file card and the following card are in the output stacker. 

Bll.l. Preparing the Card Reader 

1. Empty the read wait station. 

2. Place the reader online. 

3. Place the input deck in the hopper. 

4. Depress the reader CLEAR switch. 

5. Feed one card into the wait station. 
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B11.2. E^rror Indications 



STOP 


REASON FOR STOP 


RESULTING CONDITION 


OPERATOR ACTION 


RDR ABN 


Unit placed offline 


Recoverable 


Put online to continue. 


(Program 


while in the process 






Loop) 


of reading a card. 






6100 


Offline 


Recoverable 


Put online. 


RDR ABN 






Press START to continue. 


6140 


Not ready, hopper 


Recoverable 


Correct condition. 


RDR ABN 


empty, stacker full. 




Clear reader abnormal. 
Press START to continue. 


6140 


Misfeed — card has 


Recoverable 


One card, the card in wait 


RDR ABN 


not properly entered 




station, must be placed at 




the wait station. 




bottom of input deck. 
Feed one card. 
Clear reader abnormal. 
Press START to continue. 


6180 


Card jam or Photo- 


Recoverable 


Two cards, the last card to 




cell check error — 




go to stacker and card in 




card did not progress 




wait station, must be placed 




thru read station 




at bottom of input deck. 




properly. 




Feed one card. 

Clear reader abnormal. 

Press START to continue. 


6104 


Interrupt pending 


Not an error 


No action is required by 
operator. This display can 
occur only in conjunction with 
some other display. 



NOTE: 

■ The first two characters (61) displayed identify the stop as a Reader stop. 

■ The next two characters represent the status byte. 

■ The status byte may reflect a combination of bit settings; therefore, the operator may 
have to take corrective action for more than one error condition before attempting to 
continue. 
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B12. PRINTER DEFINITION STATEMENTS 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFPR 


BKSZ = n, 


X 






CNTL = YES, 


X 






OTBL = location of the output 


X 






translate table, 








FONT = 48, 


X 






or 








FONT = 63, 


X 






PROV = YES, 


X 






or 








PROV = location of the form overflow 


X 






routine, 








PRAD = 1 








or 








PRAD = 2 





where: n - the number of bytes to be moved from the work area to the printer buffer 
area for printing (1—132). If BKSZ is omitted, this is assumed to be 132 
bytes. 

CNTL is required only if the CNTRL macro instruction for spacing or skipping 
is used by the problem program. 

OTBL is required only if MODE = TRANS. 

PROV is required only if form overflow is not to be ignored. 

If FONT is omitted, the 63-character print bar is assumed. 

If PRAD is omitted, normal spacing is set to 1. 

B12.1. Preparing the Printer 

1. Install the proper paper loop for the program to be run. 

IOCS assumes 001 = form overflow position. 

Ill = home paper position. 

If the paper loop is absent, the paper will space one position and the CNTRL SK 
option in the IOCS routine should not be accessed. 
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2. Install the proper paper for the program to be run, 
page (matching loop). 

3. Place the printer online. 

4. Depress the printer CLEAR switch. 
B12.2. Error Indications 



and adjust it to the top of the 



STOP 


REASON FOR STOP 


RESULTING CONDITION 


OPERATOR ACTION 


Program 


Offline 


Recoverable 


Put online to continue. 


Loop 








6301 


Paper low 


Recoverable 


Correct condition. 

Press START to continue. 


6302 


Form overflow 


Not an error 


No action required by 




001 sensed at paper 




operator. This display can 




loop station, while 




occur only in conjunction 




single or double 




with some other display. 




spacing. 






6304 


Interrupt pending 


Not an error 


No action required by 
operator. This display can 
occur only in conjunction 
with some other display. 


6308 


Wrong bar setting 


Recoverable 


Insert correct bar. 


PRNT ABN 


in XIOF. 




Set bar switch appropriately. 
Press START. 


6320 


Memory overload 


Recoverable 


Press START to continue. 


6340 


Paper runaway 


Recoverable when 


Check paper loop. 


PRNT ABN 




paper position can 


Replace with proper loop. 






be reestablished 


Clear printer abnormal. 
Press START to continue. 

If form position has been lost, 
go to RESTART. 


6380 


Abnormal or not 


Recoverable 


Correct abnormal condition. 




ready 




Clear printer abnormal. 








Press START to continue. 



NOTE: 

■ The first two characters (63) displayed identify the stop as a Printer stop. 

■ The next two characters represent the status byte. 

■ The status byte may reflect a combination of bit settings; therefore, the operator may 
have to take corrective action for more than one error condition before attempting to 
continue. 
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B12.3. Paper Low 

On encountering a paper low condition, the Printer IOCS routine continues to permit 
printing until paper is homed. At this point, a paper low display is made. To assure 
proper paper positioning, a page from the new stock should be placed directly over 
the page in the printer on which the computer stopped. 

B13. SERIAL PUNCH DEFINITION STATEMENTS 



LABEL 


OPERATION 


OPERAND 


72 


Filename 


DTFRP 


CNTL^YES, 


X 






MODE=BINARY, 


X 






or 








MODE-CC 


X 






or 








MODE=TRANS, 


X 






OUAR=location of the output buffer 


X 






area, 








OTBL = location of the output translate 


X 






table, 








PUNR^YES, 


X 






TYPF=OUTPUT 





CNTL is required only if the CNTRL macro instruction for stacker selection or number 
of columns to be punched is used by the problem program. 

OTBL is required if MODE=TRANS. 

PUNR is required only if automatic error recovery (try five times) is desired for punch 
check errors. 

If TYPF is not specified, output will be assumed. 

MODE and OUAR must always be present. 
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B14. SERIAL READ DEFINITION STATEMENTS 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFRP 


CNTL=YES 


X 






EOFA = location of the user end-of»file 


X 






routine, 








INAR = location of the input buffer area, 


X 






ITBL = location of the input translate 


X 






table, 








MODE = BINARY 


X 






or 








MODE=CC, 


X 






or 








MODE=TRANS, 


X 






TYPF=INPUT 





CNTL is required only if the CNTRL macro instruction for stacker selection is used 
by the problem program. 

ITBL is required if MODE^TRANS. 

EOFA, INAR, MODE and TYPF must always be present. 
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B15. SERIAL READ/PUNCH DEFINITION STATEMENTS 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFRP 


CNTL=YES, 


X 






EOFA=location of the user end-of- 


X 






file routine, 








INAR = location of the input buffer 


X 






area, 








ITBL = location of the input translate 


X 






table, 








MODE=BINARY, 


X 






or 








MODE=CC, 


X 






or 








MODE=TRANS, 


X 






OUAR = location of the output buffer 


X 






area, 








OTBL = location of the output translate 


X 






table, 








ORLP^YES, 


X 






TYPF=COMBND 





CNTL is required only if the CNTRL macro instruction for stacker selection or 
number of columns to be punched is used by the problem program. 

ITBL and OTBL is required if MODE^TRANS. 

ORPL is required when not punching into the same card made available by the last 
GET macro instruction. 

EOFA, INAR, MODE, OUAR and TYPF must always be present.. 

B15.1. Buffer and Work Area Size 

The input buffer area and work area are each 80 bytes long if MODE^CC or 
TRANS, and are 160 bytes long if MODE-BINARY. 

The output buffer area and work area lengths are each equal to the number of 
columns to be punched, if MODE=CC or TRANS, and are each equal to two times 
the number of columns to be punched, if MODE=BINARY. 
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SECTION: 



B15.2. End-of-File 

If the Serial Read/Punch is being used for reading only, or if combined reading 
and punching is being done with overlap at the time control is transferred to the 
end-of-file routine, the end-of-file card is in the output stacker. If combined 
reading and punching is being done in a no overlap mode, the end-of-file card is 
in the punch wait station. 

B15„3. Preparing the Serial Read/Punch 

1. Empty the wait stations. 

2. Place the Serial Read/Punch online. 

3. Place the deck in the hopper. 

4. Depress the Serial Read/Punch CLEAR switch. 

5. If Reading alone or I 

/ Feed 1 card into wait station. 
Reading and Punching ) 

6. If Punching alone Feed 2 cards into wait station. 
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B15.4. Error Indications 



NOTE: 

El The first two characters (62) displayed identify the stop as a Serial Read/Punch stop. 

U The next two characters represent the status byte. 



STOP 


REASON FOR STOP 


RESULTING CONDITION 


OPERATOR ACTION ] 


PNCH ABN 


Unit placed offline 


Recoverable 


Put online to continue. j 


(Program 


while in the process 




i 


Loop) 


of punching or read- 
ing a card. 




] 
i 


6200 


Offline 


Recoverable 


Put online. 


PNCH ABN 






Clear punch abnormal. 
Press START to continue. 


6202 


Hopper empty or 


Recoverable 


Correct condition. Clear 


PNCH ABN 


stacker full. 




punch abnormal. Press 
START to continue. 


6204 


Interrupt pending 


Not an error 


No action required by 
operator. This display can 
occur only in conjunction 
with some other display. 


6208 


Photocell check 


Recoverable only if 


Two cards — card at punch 


PNCH ABN 


error indicates 


using read alone 


wait and card at read wait 




improper recog- 




station must be placed at 




nition of card 




bottom of input deck. 




presently at punch 




Feed one card. 




wait station. 




Clear punch abnormal. 
Press START to continue. 


6220 


Punch check error 


Recoverable only if 


Error card in error stacker. 


PNCH ABN 




using punch alone 


Clear abnormal condition. 
Press START to continue. 


6280 


Interlock — casework 


Recoverable 


Correct condition. 


PNCH ABN 


is open. 




Clear punch abnormal. 
Press START to continue. 


6280 


Misfeed 


Recoverable 


Clear punch abnormal. 


PNCH ABN 






Fill unit stations. 

Press START to continue. 


6280 


Stacker jam, punch 


Recoverable only 


Error card is last card to 


PNCH ABN 


entry, exit check. 


for punch alone 


go to error stacker. Clear 
abnormal condition. 
Press START to continue. 
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B16. UNIVAC 1001 CARD CONTROLLER DEFINITION STATEMENTS 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFCC 


CNTL=YES, 


X 






FUNC=location of the 1001 function, 


X 






MODE=BINARY, 


X 






or 








MODE=CC, 


X 






or 








MODE = 1001, 


X 






or 








MODE=TRANS, 


X 






or 








MODE=TRANSTC, 


X 






ITBL=location of the input translate table, 


X 






CHNL=5 thru 12 





CNTL is required only if the CNTRL macro instruction for stacker selection is used 
by the problem program. 

ITBL is required only if MODE=TRANS or TRANSTC. 

MODE = 1001, must be used with UNIVAC 1001 functions '14' and '24'. 

MODE=BINARY, CC, or TRANS must not be used with UNIVAC 1001 functions '02' 
or '0A\ 

FUNC, MODE, and CHNL must always be present with header entry card DTFCC. 
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B16.1. Work Area Size 

The work area size is a function of the Card Controller function and the mode in 
which the file is to be read. The work area size is shown in bytes on the following 
chart: 





MODE 


FUNCTION 


CC or 
TRANS 


1001 or 
TRANSTC 


BINARY 


Transfer Primary 
Transfer and Read Primary 
Transfer Secondary 
Transfer and Read Secondary 
Transfer Both 
Transfer and Read Both 


80 
80 
80 
80 


80 
80 
80 
80 
160 
160 


161 
161 
161 
161 



B16.2. Preparing the Card Controller 

(1) Ensure that the unit is online and that the power is on. (The online switch 
for the Card Controller is housed in the lower left area at the back of the 
Printer Processor Cabinet.) 

(2) Ensure that the ON-LINE Standard Interface Panel (plugboard program) is 
mounted. 

(3) Set the MODE switch to CONT; set the alternate switches (ALT 1 to ALT 4) 
off. 

(4) Empty the ready and wait stations. 

Press: CLEAR 

UNLOAD PRI (3 times) 
UNLOAD SEC (3 times) 

(5) Place the card decks in the input hopper face down, nine edge first. 

(6) Rotate the display mask switch until Step 2 appears in the indicators. 
Place the first card in the ready station by pressing: 

LOAD PRI 
LOAD SEC 
CLEAR 
START 
RUN 



(7) Ensure that Step 2 light is on. 
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B16.3. Error Indications 

When the Card Controller IOCS routine detects an error, it displays the function 
on which the error occurred, except for the 650F display. Possible displays are 
as follows: 



9200/9300 






DISPLAY 


1001 FUNCTION 


9200/9300 MODE 


6500 


Transfer Primary 


1001 or TRANSTC 


6501 


Transfer Secondary 


1001 or TRANSTC 


6502 


Transfer Both 


1001 or TRANSTC 


6504 


Transfer Primary 


Binary, CC, or TRANS 


6505 


Transfer Secondary 


Binary, CC or TRANS 


6508 


Transfer Primary and Read 


1001 or TRANSTC 


6509 


Transfer Secondary and Read 


1001 or TRANSTC 


650A 


Transfer Both and Read 


1001 or TRANSTC 


650C 


Transfer Primary and Read 


BINARY, CC, or TRANS 


650D 


Transfer Secondary and Read 


BINARY, CC, or TRANS 


6514 


Receive Data 


— 


6524 


Send Data 


— 


650F 


Not Applicable 


Not Applicable 



The 650F display indicates either a device address parity error has occurred or 
the Card Controller is offline. Check the special adapter offline switch located 
in the lower left area at the back of the Printer Processor Cabinet. Press the 
START switch on the UNIVAC 9200/9300 to reissue the XIOF. If the problem 
persists, there may be a hardware malfunction. 

For any Card Controller function display other than the 650F, if the cause of the 
error cannot be determined from the indicator lights on the Card Controller and from 
the function displayed on the UNIVAC 9200/9300 console, the IOCS routine can be 
requested to display the Card Controller sense byte in an attempt to determine the 
cause of the error. The request for this second display (STOP 2) is made by keying 
a hexadecimal 01 into location 4 and then pressing the START switch. 

B16.3.1. STOP 1 (65xx) 

The first two characters (65) of the display identify the stop as a Card Controller 
stop. The next two characters (xx) represent the Card Controller function being 
executed. 



The operator should note the stop and check the 9200/9300 panel lights. The 
Card Controller indicator lights then determine the specific type of error. 

Table B— 1 lists the possible Card Controller displays at STOP 1. Indication for 
the display is given either in the control panel lights or in the display mask 
indicator lights. 



UP-4092 
Rev. 2 



UNIVAC 9200/9300 
CARD ASSEMBLER 



Rev. 1 



Appendix B 

SECTION: 



33 



CARD 








CONTROLLER 


REASON FOR 


RESULTING 




DISPLAY 


STOP 


CONDITION 


OPERATOR ACTION 


PRI or SEC MISF 


Hopper empty or empty 


Recoverable 


Correct condition (replace damaged card if 




ready station due to 




necessary). Press PRI or SEC LOad, RUN on 




damaged card in input 




the Card Controller. Press START on 9200/9300 




hopper. 




control panel. (XIOF will be reissued.) 


STKR FULL 


Stacker associated 


Recoverable 


If STEP=02,03,04: Correct condition. 

Press CLEAR,START,RUN on 
the Card Controller. 

Press START on 9200/9300 panel. 
If STEP^02,03,04: Correct condition. 

Press RUN on the Card Controller. 

Press START on 9200/9300 panel. 
(XIOF will be reissued.) 


P or SW JAM 


Card jam at wait 1 


Recoverable 


Remove the jammed cards by opening the back frame. 




or wait 2 station 


only if stacker 


Repair damaged cards. Manually place them in the 






selection for 


appropriate stackers. Follow instructions for 






jammed cards is 


STKR FULL. 






known by 








operator. 








Otherwise, non- 


Go to RESTART. 






recoverable 




STKR JAM 


Card jam after wait 


Recoverable 


Remove the jammed cards by opening the back frame. 




2 station. 


only if stacker 


Repair damaged cards. Manually place them in the 






selection for 


the appropriate stacker. Follow instructions for 






jammed cards is 


STKR FULL. 






known by 








operator. 








Otherwise, non 


Go to RESTART. 






recoverable 




P or S RD JAM 


Card jam at Read 


Recoverable 


Card at wait 1 must be reread. Remove cards from 
ready station and wait 1 station by opening back 
frame. Place the 2 cards in proper input hopper. 

Press PRI or SEC LOAD, RUN on 1001. 

Press START on 9200/9300 control panel (XIOF 
will be reissued). 


PRGM HALT 


Possible program 


Nonrecoverable 


Take control counter reading and a memory dump. 




error. 




Go to RESTART to try again. 


STOP switch 


Switch depressed 


Recoverable 


Follow instructions for STKR FULL. 


lighted 








INTERLOCK (OFF 


Door or frame open 


Recoverable 


Follow instructions for STKR FULL. 


switch lighted) 








POWER OFF (OFF 


Power dropped 


Recoverable in 


Check the wall plug and circuit breaker at the rear 


switch lighted) 




some cases 


of the Card Controller. Press the ON switch and 
momentarily hold it on. The ON indicator should 
light and the OFF indicator should be extinguished. 

If power dropped at the very beginning of a program, 
continue the program. (XIOF will be reissued.) 

If power dropped while a program was running, go 
to RESTART. 



Table B-h UNIVAC 1001 Card Controller IOCS Initial Error Indications 
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B16.3.2. STOP 2 (65yy) 



When the cause of an error cannot be determined from the STOP 1 display, the 
Card Controller sense byte can be displayed by keying a hexadecimal 01 into 
location 4 and then pressing the START switch. The first two characters (65) of 
the display identify the stop as a Card Controller stop. The next two characters 
(yy) represent the Card Controller sense byte. 

The sense byte may reflect a combination of bit settings. Therefore, corrective 
action may have to be taken for more than one error condition before an attempt 
can be made to continue. 

Table B— 2 lists the sense byte displays for STOP 2. It also gives the reason for 
the stop and the action required to correct the error. 





REASON 


RESULTING 




STOP 2 


FOR STOP 


CONDITION 


OPERATOR ACTION 


6580 


Unspecified command or 


Recoverable in some 


Press START to reissue order. If it 




bad parity in command 


cases 


fails again, take control panel reading 




sent to 1001 control. 




and memory dump. Suspect program 
error or possible hardware malfunction. 


6540 


Operator intervention 


Recoverable in some 


Check INTERLOCK/POWER OFF 




required. 


cases 


switch plus mask position 6 in order 
to determine action required. 


6520 


Parity error on BUS OUT 


Recoverable in some 


Press START to reissue order. If 




check. 


cases 


error persists, suspect possible 
hardware malfunction. Go to RESTART. 


6510 


Data parity error causing 
a selective reset to 1001 
control or interface error 
or address error or device 
address parity error on 
BUS IN. 


Nonrecoverable 


Go to RESTART. 


6508 or 


Control logic flip-flop set 


Nonrecoverable 


Should never happen. Take control 


6504 


(primarily intended to be 
used in conjunction with 
failure-finding programs). 




counter reading and memory dump. 


6502 


Inhibit status 


Not an error 


No action required by operator. This 
display can occur only in conjunction 
with some other display. 



Table B-2. UNIVAC 1001 Card Controller IOCS Requested Error Indications 
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B17. ROW READ/PUNCH DEFINITION STATEMENTS 

The following sections describe the Row Read/Punch definition statements for punch 
only, read only, and read/ punch operation. 

B17.1. Punch Only 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFRW 


CHNL=5 thru 12, 


X 






CNTL=YES, 


X 






MODE = BINARY, 


X 






or 








MODE-CC, 


X 






or 








MODE=TRANS, 


X 






OUAR=location of the output buffer 


X 






area, 








OTBL-location of the output translate 


X 






table, 








TYPF=OUTPUT 





CNTL is required if the CNTRL macro instruction is used by the problem program. 

OTBL is required only if MODE=TRANS. 

If TYPF is not specified, output will be assumed. 

CHNL, MODE and OUAR must always be present. 
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B17.2. Read Only 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFRW 


CHNL=5 thru 12, 


X 






CNTL=YES, 


X 






EOFA = location of the user end~of=file 


X 






routine, 








INAR = location of the input buffer area, 


X 






ITBL = location of the input translate 
table, 


X 






MODE^BINARY 


X 






or 








MODE=CC, 


X 






or 








MODE---TRANS, 


X 






TYPF-INPUT 





CNTL is required if the CNTRL macro instruction is used by the problem program. 
ITBL is required if MODE=TRANS. 

CHNL, EOFA, INAR, MODE and TYPF must always be present. 
B17.3. Read and Punch 



LABEL 


OPERATION 


OPERAND 


72 


filename 


DTFRW 


CHNL^5 thru 12 


X 






CNTL=YES, 


X 






EOFA = location of the user end-of-file 
routine, 


X 






INAR-location of the input buffer area, 


X 






ITBL=location of the input translate 
table, 


X 






MODE^BINARY, 


X 






or 








MODE^CC, 


X 






or 








MODE=TRANS, 


X 






OUAR = location of the output buffer area, 


X 






OTBL = location of output translate table, 


X 






ORLP=YES, 


X 



TYPF=COMBND 
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CNTL is required if the CNTRL macro instruction is used by the problem program. 

ITBL and OTBL are required if MODE=TRANS. 

ORLP is required when not punching into the same card made available by the last 
GET macro instruction. 

CHNL, EOFA, INAR, MODE, OUAR and TYPF must always be present. 

B17.4. Buffer and Work Area Size 

The input buffer area and work area are each 80 bytes long if MODE=CC or TRANS, 
and are each 160 bytes long if MODE = BINARY. 

The output buffer area and work area lengths are each equal to the number of columns 
to be punched if MODE=CC or TRANS; and are each equal to two times the number 
of columns to be punched, if MODE=BINARY. 

B17.5. End-of-File 



POSITION OF EOF CARD WHEN GET TRANSFERS TO EOFA 




u . 




Q 

< 

LU 
DC 






X 

o 

z 

Q. 




READ ALONE 

READ & PUNCH OVERLAP 


C 
C 




B 
B 


A 
A 




EOF 








EOF 






READ & PUNCH NONOVERLAP 


B 




A 


EOF 






EOF CARD is in work area (trans lg 


ted 


if r 


equired). 








Following card, A 9 is in the input t 


)uffe 


r area INAR. 








Next card 8 B 5 is in the Row Punch 


read 


bu 


ffer verified 


for Reao 


al 


one and for Read & Punch 


overlap. 










- 





B17.6. Preparing the Row Read/Punch 

(1) Place the unit offline. 

(2) Make certain that the AC/DC light is on and the INTL/READY light is on. 

(3) Preload the punch track with blank cards by pressing manual FEED followed 
by CLEAR until a blank card is fed into the output stacker. (Jam indications 
will occur after each of the first three feeds.) 

(4) Place the input deck into the input hopper, face down, 9-edge leading. 

(5) If reading only or reading and punching, feed one card. 

(6) If punching only, feed three cards. 

(7) Press CLEAR on the row read/punch. 
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(8) Place the unit online. At this time: 

■ The AC/DC light must be on. 

■ The INTL/READY light must be on. 

■ All other lights must be off. 

NOTE: In order to clear error lights on the unit: 

(1) Correct the error condition at the unit. 

(2) Press: 

(a) OFFLINE 

(b) CLEAR 

(c) OFFLINE 

B17.7. Error Indications 



STOP 


REASON FOR STOP 


RESULTING CONDITION 


OPERATOR ACTION 


Looping on A5, 


Unit nonoperational (in 


Recoverable. 


Correct the condition to con- 


47 instruction 


OPEN coding). 




tinue. 


640F 


Unit nonoperational. 


Recoverable. 


Correct the condition. Press 
START to continue. 


6401 


Hole count error. 


Recoverable 


The error card and following 






for punch alone. 


card are diverted to the error 
stacker. 

Press START to repunch last 
two cards and continue. 
(NOTE: if PUNR=YES, this 
stop will not occur as IOCS 
will provide automatic 
recovery.) 


6402 


Parity error on data 


Recoverable. 


All cards in wait stations are 


INTL light on 


transfer during execu- 




assumed to be good. 


and no error 


tion of a LOAD or 




Press START to continue. 


lights on 


UNLOAD XIOF. 




(XIOF will be reissued.) 
If the card at the post punch 
station is bad or if the error 
persists, suspect a hardware 
malfunction. Restart. 


6402 


HOPPER empty. 


Recoverable. 


Correct the condition. 


error light on 


CHIP box full. 




Press OFF LINE, CLEAR, 




STKR full. 




OFF LINE. 




STKR jam. 




Press START to continue. 
(XIOF will be reissued.) 
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STOP 


REASON FOR STOP 


RESULTING CONDITION 


OPERATOR ACTION 


6402 


One of following con- 


Recoverable. 


Correct the condition. 


INTL light off 


ditions: 




The INTL, light must be ON. 




■ Punch assembly and 




Press OFF LINE, CLEAR, 




upper card feed 




OFF LINE. 




raised or improperly 




Press START to continue. 




seated. 




(XIOF will be reissued.) 




■ Read station brushes 








not in place. 








■ Protective covers 








not in place. 






6402 


Misfeed or card jam. 


Recoverable in 


READ ONLY: 


A JAM or 




some cases for 




B JAM 




read only or 


Remove the cards from the 


Light on 




punch only. 


input hopper. 

Place the unit offline. 

Open the punch frame. 

Remove all cards from the 

track. 

Repair the damaged card. 

Place the cards in the input 

hopper. 

Replace the rest of the deck 

in the input hopper. 

Press CLEAR on the unit. 

Feed three cards. 

Close the punch frame. 

Press CLEAR, OFF LINE. 

Press START to continue. 

(XIOF will be reissued.) 

If nonrecoverable, restart. 

PUNCH ONLY: 

The card at the post punch 

station is assumed to be in 

error. 

Place the unit offline. 

Open the punch frame. 

Remove all cards from the 

track and discard. 

Press CLEAR on the unit. 

Feed three cards. 

Close the punch frame. 

Press CLEAR, OFF LINE. 

Press START to continue. 

(XIOF will be reissued.) 

If nonrecoverable, restart. 
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STOP 


REASON FOR STOP 


RESULTING CONDITION 


OPERATOR ACTION 


6404 


Device end. 


Not an error. 


\ 


6408 


Channel end. 


Not an error. 


/ No action is required by the 
I operator. These displays can 


6410 


Busy. 


Not an error. 


( only occur in conjunction 
\with some other error., 


6440 


Status Modifier. 


Not an error. 


/ 


Power OFF 


Power dropped during 
execution of program. 


Nonrecoverable. 


Restart. 



B18. IOCS GENERATION 

The Preassembly Macro Pass for a card reader, serial punch, 8K UNIVAC 9200/9300 
configuration allows approximately 2700 bytes for macro library storage. IOCS macro 
library routines require approximately the following number of bytes of storage: 





NUMBER 


ROUTINE 


OF BYTES 


Reader (DTFCR) 


600 


Printer (DTFPR) 


1200 


Serial Read/Punch (DTFRP) 


1800 


Card Controller (DTFCC) 


2200 


Row Punch (DTFRW) 


2400 



B19, ADDITIONAL KEYWORD PARAMETER SPECIFICATIONS 

Certain additional keyword parameter specifications have been built into the DTFCR, 
DTFRP, and DTFRW macro definitions to provide functions designed primarily for 
Univac Systems Programming use. These parameters are available and can be used by 
the user if he so desires. These parameters are as follows: 

■ SENT = X 'value' — The IOCS routines test for standard end-of-file sentinels 
(slash in column 1 of the input cards). The above parameter may be used if 
something other than the standard sentinel is to be tested. If MODE=CC or TRANS, 
the IOCS routine tests word zero in the input buffer against X'34\ If MODE = BINARY, 
the IOCS routine tests for X'OC. Only one byte is tested; therefore, the value 
specification must be only one byte in length. 

■ SENT = NO — This parameter may be used if no EOF sentinel test is to be made 
by the IOCS routine. Coding for the EOF test will be eliminated during the macro 
pass if SENT=NO is present. 

■ INCR=m — This parameter may be used if the user expects the EOF sentinel in a 
column other than column 1. The specification m is a variable, numeric quantity 
indicating column n— 1. 
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APPENDIX C. CARD LOAD ROUTINE 



C 1. GENERAL 

The Card Load Routine for the online card reader and the 80-column UNIVAC 1001 Card 
Controller consists of the following sections of coding: 

a. Bootstrap coding to read the Load Routine into memory. Before transferring control 
to the Load Routine, the bootstrap coding sets the EBCDIC mode and enters the 
processor state. 

b. Coding to clear a selected portion of memory to a selected character. This coding 

is executed before the Load Routine itself is read into memory. If the area specified 
to be cleared includes the Load Routine and its read area, they are not cleared. 

c. Coding to load a program in Assembler output format into the internal storage of the 
UNIVAC 9200/9300. The Load Routine performs a hole count check of each card 
used. Upon encountering a Transfer Card (a card with Y in column 2) signifying 

termination of loading, the Loader compares the number of External Reference (type 
K), Text (type Y), and blank cards read with the number contained in columns 12 and 
13 of the Y card. If the numbers agree, the Load Routine loads register 13 with the 
address at which to begin program execution and transfers control to that address. 
This is the address contained in columns 15 and 16 of the Y card. If these columns 
are blank, the transfer address used is that contained in columns 15 and 16 of the 
program reference card (type J). 

If the card count check fails, the Load Routine halts. At this point pressing the 
START switch causes the Load Routine to begin execution of the program just 
loaded. During the loading of the EXEC I portion of a program, the Load Routine 
sets up the I/O PSC for EXEC I. 

The name of the Load Routine for the online card reader is LD; for the Card Control- 
ler, LDCC. 



C2. PARAMETERS FOR THE LOAD ROUTINE 

The Load Routine can be maintained as an object code deck ready to be linked. Certain 
labels exist as external references. Defining these labels supplies the variable infor- 
mation required by the Load Routine. These labels may be defined by means of EQU 
control cards at the time the Load Routine is linked to a program. The external labels 
and their meaning are shown below. See 5.6 for further use of these labels. 
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LABEL 



MEANING 



L?AR 

L?PG 

L?LO 

L?HI 

L?CH 

L?AM 



Start of the read area for the Load Routine. 

Start of the coding of the Load Routine. 

First memory location to be cleared. 

Last memory location to be cleared. 

Character with which to fill the area to be cleared. 

The value assigned determines whether alterations are to be 
stored in memory location 4 or the memory location specified in 
the address switches. If the value assigned is four, alterations 
are stored in location 4; if zero, in the location specified by the 
memory address switches. 



Note that all labels used by the Load Routine begin with the characters "L?". 

The read area for the Load Routine is 80 bytes long and does not have to be contiguous 
with the Load Routine, but each must begin on a halfword boundary. The coding for 
the Load Routine is approximately 275 bytes long in the case of routine LD and 
360 bytes long in the case of routine LDCC. 



The Load Routine is coded relative to the labels L?AR and L?PG. Thus, once these two 
labels are defined by EQU cards, the location at which the Load Routine and its read 
area reside in memory is fixed. In setting up the Linker input deck the user must be 
certain that the Linker does not allocate to any other part of the phase in which the 
Load Routine appears the memory that has been allocated to the Load Routine by the 
L?AR and L?PG EQU cards. 

When the Load Routine is linked to a program, it must appear as the first element in 
the input deck for the first phase of the program being linked. To produce a self-contained 
loader that will load the object program that follows it, add an END card with an operand 
of L?PG to the Load Routine deck and link the loader separately. 

For routine LDCC, L?AR must be set equal to 160 or more. 

C3. LOADING ADDITIONAL PROGRAMS 

If the Load Routine is in memory, it may be used to load another program by branching 
to the initial location of the Load Routine (represented by the tag L?PG). The program 
to be loaded must not overlay the Load Routine or its read area. The first card 
loaded will be the card at the wait station at the time L?PG is branched to. 

A terminating program may also initiate the loading of a successor program if the suc- 
cessor contains a load routine of its own. The program must read the first card (boot- 
strap card) of the successor into a location in memory, set the address of that location 
into register 15, and transfer to that address plus 26. The address chosen for the boot- 
strap card must not overlap either the load routine of the successor program or the 
read area of the Load Routine. The bootstrap card must be read in in compressed code 
and must not be translated. This facility is possible only if the online card reader is 
being used to load programs. 
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C4. LOAD ROUTINE STOPS 
DISPLAY 



4300 



61ss (LD) 
65CE (LDCC) 



61ss (LD) 
(Reader 
abnormal 
light on) 

6504 
650C 



MEANING 



Card Count error 



Hole count error: 
sum of the bytes 
read from columns 
8—72 does not agree 
with the hole count 
byte column 7 (ss 
has no meaning). 

Card Read Error 
(ss is the status 
byte) 



Card Controller 
error 

Card Controller 
error while trying 
to execute a TR & 
RD PRI or TR PRI 
function 



ACTION 



Press START to begin execution 
of program just loaded. 

Press START to ignore the 
card and continue loading. 



Press READER, CLEAR. 
Refeed the error card (if any). 
Press START to continue 
reading. 

Nonrecoverable, Less than 10 cards 
have been read. Start over. 

Recoverable in some cases. Cause of 
error may be determined by the display 
lights on the Card Controller. Check the 
masks and follow the error recovery pro- 
cedure as outlined under STOP 1 of the 
Card Controller IOCS operating instruc- 
tions; however, the sense byte display 
(STOP 2) cannot be made available in 
the LOADER. 



The 61ss displays are applicable to the LD Load Routine only. 

In the case of a card read error, the error is at the top of the output stacker and is 
present unless the error is misfed, not ready, offline, hopper empty, or stacker full. 

C5. DESCRIPTION OF OPERATION 

The Card Load Routine consists of four parts: Boot, Reader, Clearing, and Loader 

C5.1, Bootstrap Section 

The Bootstrap section is the first card in the Load Routine and is read into privileged 
memory (0—79) by a console operation. The Bootstrap section is a card reader routine 
that reads the next card in the input hopper into L?AR and exits to the first instruction 
(at LPAR+10) on the card read. The first instruction at,L?AR+10 stores the remainder 
of the card into L?PG. The instruction that follows transfers control back to the Boot- 
strap section. This cycle of reading and storing of cards continues until the Reader 
and Clearing sections are stored in L?PG. The last card of the Clearing section read 
into L?AR sets all alteration switches as determined by the value in L?AM, sets 
further operations under processor PSC, and transfers control to the Clearing section 
coding in the L?PG area. 
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C5.2. Clearing Section 

The Clearing section clears memory specified to the specified character except for 
the privileged area and the L?PG area. Control is then transferred to the Reader 
section in the L?PG area to read in the Loader section. 

C5.3. Reader Section 

The Reader section reads the next card in the input hopper into L?AR and exits to the 
first instruction on the card which stores the remainder of the card into L?PG above 
the Reader section. The second instruction on the card transfers control back to the 
Reader section in L?PG to read the next card. The cycle continues until all the cards 
making up the Loader Section are read and transferred into L?PG. The last card on the 
Loader section read into L?AR changes the transfer-control address in the Reader 
section from LPAR+10 to the Loader section. Control is then transferred to the Loader 
section. 

C5.4. Loader Section 

This section remains in the L?PG area with the Reader section during the loading 
process. The Reader section brings in the program cards. The Loader section checks 
the hole count and the card count, loads the program from the Text (Q) cards, and on 
detection of a type Y (END) card, determines the start address, places the start 
address in register 13, and transfers control to it. The Loader section loads the 
I/O PSC with the first four bytes of data (columns 11 — 14) of any type Q (Text) card 
with a load address of 16. 



C6. PROGRAMMING CONSIDERATIONS 

In situations where memory is at a premium, it is possible to use the problem program 
I/O areas to store the Loader and then overlay the Loader with input or output data. 
This can be accomplished by the following example: 



Coding 








LABEL 


OPERATION 


OPERANDS 


COMMENTS 




CTL 


2,8191,8191 






PHASE 


UNI, 256, A 


Program UNI will start at location 
256 absolute. 


L?AR 


EQU 


160 


80 byte read-in area begins at 
location 160. 


L?PG 


EQU 


240 


Loader will be loaded starting at 
location 240. 


L?HI 


EQU 


8191 




L?L0 


EQU 


160 


Locations 160-8191 will be cleared 
to zero before loading loader. 


L?CH 


EQU 







L?AM 


EQU 


4 


All alterations will be stored in 
location 4. 



■ LD or LDCC object code deck 

■ Problem program starting with DS statements for I/O areas and working areas. 

■ Other elements 

■ END card 
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In the above example, the problem program must have the DS statements for I/O 
areas and working areas as the first lines of coding. The total memory requirements 
of all DS statements must be greater than 275 bytes when using the card reader loader, 
or 360 bytes when using the 1001 Card Controller loader. If the total of the DS state- 
ments is less than this, the starting address in the PHASE card must be adjusted to 
make up the difference so that the loader will not be overlayed before loading has 
been completed. 

Text cards are not punched for DS statements; therefore, nothing is loaded into these 
memory locations at load time. Thus, if this approach is used, the problem program must 
clear the output areas before using them, as they may contain parts of the Loader routine. 
It should be noted that the loader is then destroyed and must be loaded again for any 
subsequent programs. 

The example above also can be used for creating a freestanding loader, except that 
no problem program or other elements will follow the loader deck. Still required is a 
PHASE card, in which any fictitious parameters may be used. 

C7. LOADING FROM CARD READER. 

1. Place program deck in hopper. 

2. Press READER CLEAR, READER FEED. 

3. Set DATA ENTRY switches to 0000 0001. 

4. Press general CLEAR. 

5. Set LOAD. 

6. Press START. 

7. Reset LOAD. 

8. Press START. 



C8. 1001 LOADER LOADING PROCEDURE 

1. Remove all cards from the PRI hopper of the Card Controller by pressing UNLOAD 
PRI three times. 

2. Place program deck in PRI hopper. 

3. Set the ALT 1 switch on. 

4. Press the CLEAR, LOAD PRI, CLEAR, START, RUN, switches on the Card 
Controller. 

5. Set the ALT 1 switch off. 

(5. Enter the device address in the DATA ENTRY switches of the 9200/9300. 
(Example: The Card Controller is on channel 7; therefore, enter B8 in DATA 
ENTRY switches. B8 = 10111000) 



T 



■channel 7 



must always be 1 
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7. Press the PROC CLEAR, CHANNEL CLEAR switches on the 9200/9300. 

8. Press the LOAD switch on the 9200/9300. 

9. Press the START switch on the 9200/9300. 

10. Reset the LOAD switch on the 9200/9300. 

11. Press the START switch on the 9200/9300. 
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APPENDIX D. EXEC I 



Dl. GENERAL 

EXEC I is designed for UNIVAC 9200/9300 Card System only and takes the form of a 
relocatable element which must be included in the worker program at Linker time. The 
primary functions of EXEC I are to monitor interrupts, handle messages to and from 
the operator, and provide restart communication. 

D2. MACRO INSTRUCTIONS 

EXEC I provides the following macro instructions: 

D2.1. Message Macro (MSG) 

The message macro has the format given below: 

OPERATION OPERAND 



MSG 



Message, REPLY 



The REPLY parameter is optional. Message may be any acceptable two-byte hexadeci- 
mal expression of the form X'nnnn'. 

This macro generates the following code: 



OPERATION 


OPERAND 


SRC 


0,8 


DC 


Y(message) 


DC 


CLl'x' 


DC 


X'0' 



where message is the two-byte hexadecimal display which appears in the HPR instruc- 
tion. It takes the form of an assembler language expression. 

x = A, if the parameter REPLY appears; x = a blank (EBCDIC code 01000000), 
if it does not. 

The one-byte reply, keyed in by the operator into location 4, appears in the last byte 
of the calling sequence. 
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EXEC I responds to this macro by doing a BAL, using register 15, to its own display 
subroutine. It moves the message from the calling sequence of the SRC instruction 
to the calling sequence of the BAL instruction before executing the BAL instruction. 
The display subroutine sets location 4 to binary zero and displays the message by 
means of an HPR instruction. When the START switch is depressed, the display sub- 
routine returns control through register 15. EXEC I then moves the contents of location 
4 to the reply byte of the calling sequence and returns control to the problem program. 

For example, if the user codes the following macro instruction, 

DSPL MSG X'FFF\ REPLY 

the Assembler treats this macro instruction the same as the following source code: 

DSPL 



SRC 


0,8 


DC 


Y(X'FFF') 


DC 


CLl'A' 


DC 


X'0' 



When the object code produced from this source code is executed, the computer stops 
with a display of 000111111111111. The operator may then answer this display using 
the DATA ENTRY and ALTER switches. When the START switch is subsequently 
depressed, control- is returned to the user's coding at the instruction located at 
DSPL + 8. The byte inserted into the computer by the operator through the DATA 
ENTRY and ALTER switches is in location DSPL + 7. If the operator did not intro- 
duce any data through the DATA ENTRY and ALTER switches, then on return of 
control to the problem program, the byte in location DSPL + 7 contains binary zeros. 

The MSG macro instruction is not handled by the Preassembly Macro Pass, but is 
processed by the Assembler itself. 

D2.2. Restart Macro 

The restart macro has the following format: 

OPERATION OPERAND 



RSTRT 



Restart-name 



The restart-name is the label of a user-coded routine which is designed to handle a 
restart operation. 

This macro generates the following code: 

OPERATION OPERAND 



SRC 
DC 



0,0 
Y(Restart-name) 
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SECTION: 



In response to this macro instruction, EXEC I stores the address of the restart-name. 
Restart is accomplished by a general clear followed by depression of the START 
switch. This causes the instruction in memory locations 22 through 25 to be executed 
in I/O mode. EXEC I has a branch unconditional instruction in this location that allows 
it to force all alterations to be stored in memory location 4, set the processor PSC to 
the restart-name and then go to RE-ENTRY. At RE-ENTRY, EXEC I sets the device 
address byte to zero, resets (without destroying the SRC field) the I/O PSC in pre- 
paration for the next interrupt, and returns to processor state. 

At the restart-name location the user must provide a restart routine. This routine must 
re-establish variable information in the program and set initial conditions for all input/ 
output routines. (To aid the user in accomplishing this goal, the execution of the OPEN 
macro resets the initial conditions for all IOCS routines.) The user must establish 
conventions to reposition card decks and printer paper. 

The RSTRT macro instruction is not handled by the Preassembly Macro Pass, but is 
processed by the Assembler itself. 

D3. I/O CONTROL ROUTINE MESSAGES 

All IOCS routines operating in I/O mode may display messages through direct access 
to the display subroutine. After execution, if a reply is expected, the control routine 
itself must'examine the contents of location 4, 



The following instructions are required to execute a display: 



OPERATION 



BAL 
DC 



OPERAND 



15,E?DS 
XL2'message' 



where E?DS is the label for the first byte of the display routine, 
message is a two-byte hexadecimal expression. 
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APPENDIX E. TRANSLATION TABLES 



El„ GENERAL 

The UNIVAC 9200/9300 I/O software enables any desired internal 8-bit code to result from 
the reading of most punch configurations, to be punched into nearly any desired punch con- 
figuration, and to cause printing of any character of a 63- or 48-character font. This is 
accomplished by the optional use of automatic translation in the I/O routines. Input/output 
data is translated according to specified translation tables. The programmer may use his 
own translation tables or he may use any of the standard translation tables. 

Standard translation tables are available in source code form and in object code form. The 
source code form can be assembled with another program or can be assembled by itself to 
provide a linkable element. The object code form is a relocatable element with its name 
defined by the External Definition (type H) card. Each table occupies 256 bytes of object 
memory. 

There are three standard translation tables; Table Read, Table Punch, and Table Print. 
Each table is used by the appropriate, associated I/O routine. 

Table Read, TBRD, converts the compressed image read from Hollerith-coded input cards 
to internal EBCDIC code. 

Table Punch, TBPU, converts the internal EBCDIC code to a compressed image that pro- 
duces output cards punched in Hollerith code. 



Table Print, TBPR, converts the internal EBCDIC code to a code which causes the 48- 
character print bar to print the same character as would be printed if the 63-character 
print bar were used. Characters other than 0—9, A— Z, and .+&$*-/, %'#@ are treated as 
blanks. 



UNIVAC 

FEDERAL SYSTEMS DIVISION 

UP 4092 - fcev 2 MAY 1968 



